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PREFACE 



c 



You are about to meet a friendly computer! Friendly in price, ^ 

friendly in size, friendly to use and learn on and experience. ^ 

Most important — you don't hiave to be a computer r 
programmer, or even a typist, to use it ! 

If you're a first time computerist, this manual will provide an ^ 

excellent introduction to computing. Unlike most instruction ( 

manuals, you don't have to read through this whole book to get 

to the "good stuff." After reading Chapter 1 (GETTING C 

STARTED), you can go directly to a chapter that interests you r 

and start reading. If you're interested in animation turn to 

Chapter 4. If you like music, try Chapter 5. ( 

The first page of each chapter has a sample program to start ( 
you off. Just type the program exactly as shown ("Try Typing 

This Program") and see what happens. The rest of the chapter C 

explains what you did, and shows you how to do more. Chapter ^ 

7 summarizes some important programming concepts, and ^ 

explains the techniques used in the sample programs. ( 

If you're an experienced programmer, you can use the VIC like r 
any microcomputer. Familiarity with Commodore computers 

will help, since the BASIC and graphics are nearly identical to ( 
those used in the PET/CBfvl. Advanced reference material and 

programming information are included in the Appendix. For *- 

more sophisticated programming, see the VIC PROGRAMMERS r 
REFERENCE GUIDE, available from your Commodore dealer. 

If you're a noncomputerist and have no interest in ^- 

programming, per se, you should check out the VIC's growing C 
library of plug-in cartridges and program tapes. VIC cartridges 

plug directly into the back of the console and work C 

automatically. Programs are also provided on cassette tapes for r 

use with the Commodore Cassette Tape Recorder, ^ 

Cartridges and tapes include exciting "arcade-type" games ^ 

such as "VIC INVADERS" as well as educational programs to ( 
help you develop special skills, and home utility programs to 

help you solve problems and perform calculations. C 

Peripherals and accessories for the VIC include the VIC tape C 

cassette recorder, single disk drive, telephone modem and 

printer, to name a few. (See Appendix A) C 

Computers are becoming an increasingly important part of our C 

everyday lives — in our homes, at school and in business. ^ 

Those who become familiar with computers now will have an ^ 

important advantage in the coming months and years. The VIC r 

not only introduces you to the world of computing, but also 

gives you the features and flexibility you need to expand that C 

world. 

r- . C 

Enjoy your new world! 
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UNPACKING AND CONNECTING 
THE VIC 20 

Welcome to computing! Ttie foliowing step-by-step instructions show you how 
to unpack the VIC, connect it to your television set and make sure it's working 
properly. 

Let's begin by taking a quick 
look at the VIC 20: 



KEYBOARD 
(used to type 
information 
and instructions 
into the computer) 



POWER LIGHT 
{glows when your 
VIC is turned on) 




POWER CORD 
SOCKET 
(Attach power 
supply here) 



GAME PORT 
(for joystick 
and other 
game control 
devices) 



ON/OFF 
SWITCH 



EXPANSION 

PORT 

(VIC Program 

cartridges 

plug in here) 




USER PORT 
(For special 
accessories) 



SPIN 

VIDEO 

PORT 

(For 

connection 

to TV set 

or monitor) 



SERIAL 
PORT 

(For special 
accessories 
like printer. 
disk drive, etc.) 



CASSETTE 
PORT 
(Tape 
cassette 
goes here) 



1. 

2. 
3. 

4. 



8. 



Check the contents o( your VIC container. You should find the 
following items; 

— VIC 20 Personal Computer 

— Power Supply (large box with 2 cords coming out of it) 

— RF Modulator (small metal box) and short cable* 

— Video Cable 

You will need 2 electrical outlets (sockets) — one for the VIC and 
one for your television set. 

Position the VIC and Television set so you can use the keyboard 
comfortably white viewing the television screen. ..ideally, a tabletop 
or desk. 



Find the ON/OFF switch on 
the right hand side of the VIC. 
Make sure it's in the "OFF" 
position. 

There are two cords coming 
out o' the power supply box. 
Plug the power supply cord 
into an electrical outlet and 
plug the other cord into the 
power cord socket on the side 
of the VIC. NOTE: The power 
supply remains "on" while 
plugged in so you should 
unplug it when not in use. 



Connect the video cable to 
the back of the VIC and to the 
RF Modulator box, as shown. 
Make sure to connect it to the 
video port and not to the 6-pin 
serial port, which is next to it. 

Connect the RF Modulator to 
your television set. For this 
you'll need a screwdriver. The 
short TV cortnector cord runs 
from the RF Modulator box to 
the 2 VHF Antenria leads on 
the back o( your television. 
Simply connect the two wires 
to the VHF leads and tighten 
the screws firmly.* 

Turn on the TV set. 




ON/OFF SWITCH 



--^*\- 




POWER 

CORD 

. SOCKET 



POWEB 
SUPPLY 



^ 



REAR VIEW OF THE VIC 




VIDEO 
PORT 



RF MODULATOR 
O 




VIDEO 
PLUG 



CONNECT 

WIRE LEADS 

TO ANTENNA 

LEADS ON 

YOUR TV 

SET 



VIDEO 
CABLE 

REAR VIEW OF 
TV SET 



@® VHF 



RF MODULATOR 



w 



Note; Some VICs are provided wiih a "switchbox" which attaches between ihe RF modulator and TV sei. 
The switchboK contains a switch with setlings for "computer" and "TV and should be sei \a "compuief" 
when using Ihe ViC, 
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TROUBLESHOOTING CHART 



SYMPTOM 



CAUSE 



REMEDY 



NO PICTURE 
(POWER LIGHT OFF} 



VIC not "on" 



Make sure power switch 
is in "on" position 



VIC not plugged In 



Ctieck power socket 
next to power switch 



Power supply not 
plugged In 



Check connection with 
wall outlet 



Bad fuse In VIC 



Take VIC to your 
Authorized Commodore 
Service Center for 
replacement of fuse* 



NO PICTURE 

(POWER LIGHT ON) (Try turning VIC off for a few seconds, then back on) 

TV on wrong channel Check Channel 3 & 4 for 

picture 



Incorrect fiookup 



VIC hooks up to "VHP" 
terminals on TV 



Modulator not plugged 
In 



Check connection at 
5-pln Video Port 



Modulator on wrong 
channel 



Flip switch on Modulator 



Video cable not 
connected 



Check connection on 
modulator 



PICTURE WITHOUT 
COLOR (TRY TV &. 
MODULATOR ON 
CHANNEL 3 & 4) 



Poorly tuned TV 



Retune TV 



PICTURE WITH 
POOR COLOR 



Bad color adjustment on 
TV (see "picture without 
color") 



Adjust color/hue/ 
brightness controls on 
TV 



PICTURE WITH 
EXCESS 
BACKGROUND NOISE 



TV volume up too high 
(see "picture without 
color") 



Adjust volume of TV 



PICTURE OK, 
BUT NO SOUND 



TV volume too low 



Adjust volume of TV 



•The VIC uses a 3 amp SLO-BLO fuse. 

V)) 




10. 



11, 



12. 



Turn on the VIC (the red 
power light on the top of the 
computer should come on). If 
the power tight does not. 
consult the accompanying 
troubleshooting chart. 

There is a switch on the RF 
Modulator for selecting either 
Channel 3 or 4. Choose the 
channel with the weaker 
reception in your area, and set 
both the TV and the 
Modulator to that channel. 
The fine tuning on your 
television may need some 
adjustment. 

Here is what you should see 
on the screen — sometimes it 
takes a second or two to 
activate. If you don't get the 
following display on your 
screen, turn the computer off, 
wait a few seconds and turn it 
on again. 

Adjusting the color and 
tint/hue depends on the color 
controls provided on your 
television set — naturally, 
sets with better controls yield 
better color. Some sets show 
some colors better than 
others. 

If you have trouble with any of 
these steps, consult the 
accompanying 
troubleshooting chart. 




NOW. ..you are ready to start using the VIC. 

NOTE: You can use a monitor instead of a television set — in which case you 
can go directly from the VIC to the monitor cable, without the RF 
Modulator. 



C' 
C' 

c 
o 
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IF ALL ELSE FAILS-CALL THE TOLL-FREE 
COMMODORE TECHNICAL HOTLINE... 

1-800-523-5622 



VIII 
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Try typing this program: 

Type this program exactly as shown and see 
what happens! 




To stop the program, press the 




i 
C 

C 

c 
c 
c 
c 
c 
c 
c 
( 
( 
c 
c 
c 
c 
c 
c 
c 

( 

c 
c 

c 
c 
c 



c 
( 

c 
( 

( 

( 
c 



GETTING STARTED— 
EXPERIMENT A LITTLE 

You made it! Your VIC is aglow with color and ready for you 
to tell it what to do. Ttie dark blue, blinking rectangle, called 
ttie cursor, is a signal from the VIC that it is waiting for you. 




VIC TIP: 

If you type a character on the screen that you don't want, press the 
key. 




This key will erase the character immediately to the led of the blink- 
ing cursor. 

Use this key as often as you like to delete unwanted characters. 



Now, on with the tour! Begin by pressing the following keys: 

E S E E] m 

See how the cursor moves over one position every time you 
press a key? The cursor tells you where the next character is 
going to appear on the screen, OK, now find the SHIFT key, it 
looks like this: 




There are two of them, both the same. 

3 



Hold the 
press; 



key down, and while it is being held, 



You can release the mm^ Key after you press the 
The screen should look like this: 



key. 



( 

c 



CfiM BASIC V2 
3583 BYTES FREE 
READY. 
PRINT"-^' 




Pressing the ^^ key while holding down the 

key caused the quotation mark to appear on the screen.* 
Let's continue. Now press the following keys: 

[S HCQE] [I] [o] [w] 



Finally, hold down the 
key once again. The screen 
now shows: 



key, and press the 



CBM BASIC V2 

3583 BYTES FREE , 

READY. 

PRINT "RAINBOW" 



'Note: if the nunnber 2 appeared on the screen inst ead o f the 
" sign, you didn't hold down the shift key. Hit the 
once to erase the 2 and try again. 
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Look for this key: 
Press the 



key and look at the screen. 



****CBM BASIC V2 
3583 BYTES FREE 
READY. ^ 

PRINT "RAINBOW" 
RAINBOW - : 




READY 



Pressing the ^m|j||^g key told the VIC you were finished 

typing. The VIC then looked at what you typed, recognized 
that it was being asked to do something (actually, you told it 
to print something). The VIC then PRINTed everything between 
the two quotation marks {RAINBOW}. 

When the VIC finished PRINTing the word RAINBOW, it let 
you know by displaying the READY message and blinking the 
cursor. 

It's your turn. Go ahead and enter some other PRINT 
messages for your VIC to display. Try these or make up your 
own: 



[pismsEHdHcniNiH 



Press 



here 



BiamsmEEiiEiBEioiQ 

ESm SB SEE BE] as 

5 




Experiment by using characters other than letters between the 
quote marks: The VIC won't mind. Note: If you misspell the 
word PRINT, the VIC will let you know by displaying this 
message on the screen: 



7SYNTAX 
EPROR 




c 
c 
c 



Don't worry. There is absolutely no way you can hurt your VIC 
by typing at the keyboard (unless, of course, you're an 
elephant), but, if you make a mistake, the VIC will help you out 
by calling attention to the error. These error messages and 
what they mean are listed in AppendixN. At this point, don't 
worry about the "SYNTAX ERROR" message. Just keep 
experimenting. 

In no time your screen gets cluttered with all the stuff you've 
been typing. The VIC has a handy way to CLeaR up this clut- 
ter. To tell the VIC to "clear" the screen, do the following: 



Hold down the 
the O key. 



key and press 
IMPORTANT 




The screen clears instantly; everything you and the VIC have 
typed disappears. You are left with a clean white display area 
and a blue cursor blinking away in the upper left hand corner. 

Remember how you told the VIC to do this feat. Clearing up 
the screen is one of the more frequent commands you'll be 
using as you get to know your VIC. 



c 
c 
c 
c 

• 
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YOUR FIRST 
COMPUTER "PROGRAM" 

If your VIC performed well in displaying your messages, no 
matter how bizarre they might have been, then your computer 
is probably ready to do just about anything. Let's begin by 
"entering" your first computer program. 

STEP 1: Clear the screen by holding 
down the H^^H key and 

then pressing the 
STEP 2: Type; [n] [E] [w] and press the 



STEP 3: Type: [T][o] EEESHH 

[V] [D [C] U [O] □ [H^^seml-colon 
and press v ^ Use the 




VIC TIP: EDITING MISTAKES IN A PROGRAM 

If you make a mistake on a line, you have these editing options: 

1. You can retype a tine anytime and the VIC will automatically 
substitute the new line for the old one. For example, if your pro- 
gram looks like this: ^--^-^.^^^ /--yWV^^ 

10 PHiNN "VIC20'' \Wnislake J 

20 GOTO 10 ^^•'\ „J-^ 

You can skip down by hitting ^^^^^^; a tew times and type: 
10 PRINT '■V1C20" 



Now, the new line has replaced the old line and the program M\\ 
"run". To make sure, type [l][T][s3[t] ■ Replacing lines in a pro- 
gram is also a quick and easy way to experiment. 

2. You can er ase an unwant ed tine by typing the number of that line 

and hitting ^^^^^^H . The entire line will be erased from 
memory, ^^nnm^^ 

3. You can edit a line by using the cursor keys to move to the 
character(s) in the line of a program you want to change, typing in 



a program over them and hitting 



Note that quota- 



tion marks sometimes confuse the VIC— if you get unwanted 
characters after quote marks, go back to the beginning of the line 
and type it over. 



4. The INST key (get it by typing 



) lets you 



insert characters by opening up spaces in a word or line you've 
already typed. 



5. The DELETE key (just type 
diately to the left of the cursor, 



) erases characters imme- 



If everything looks all right to you, type the following word, 
and press ^^^^^H 

IJ @ [1 ^^^1 here 

The screen should fill with VIC20. At times, it looks like small 
animated letters traveling up the screen. 



c 

c 



VIC20VIC20V!C20VIC20VIC20V1( 
I C20VIC20V1 C20VIC20VIC20V1 C20> 
:20VIC20VIC20VIC20VIC20VIC20V 
20VIC20VIC20VIC20VIC20VIC20V 
DVIC20VIC20VIC20VIC20V1C20VI 
'IC20VIC20VIC20VIC20V1C20VIC20> 
C20VIC20V IC20VIC20 V I C20 V IC20 V 
20VIC20VIC20VIC20V1C20VIC20V 
OVIC2OVIC20VIC2OViC2OVIC2OVI 
'IC20ViC20VIC20VIC20ViC20VIC20^ 
'IC20VIC20VtC20VIC20VlC20VIC20^ 
'IC20VIC20VIC20VIC20VIC20VIC20* 



Want to slow down the program? Press the key on the left 
side of the keyboard marked: 



If you hold down the Mill key, the program slows down. 

Amazing! Your VIC is fud of wonderful features. Here, with 
just a single key, you are telling the VIC to reduce how fast it 
is displaying stuff on the screen. 

Yes, but how do you STOP the program? Good question. Look 
around the keyboard until you find this key: g^ffiH 



Press the yyjg key. The program should stop, and the 
message: 

BREAK IN 10 
READY 

should appear on the screen. (Don't worry, you didn't break 
the VIC— "break" means "stop" in VIC language). Also, the 
cursor should reappear. Did you notice that it was gone white 
it was printing? 

Now, let's take a look at your program and see if it's still 
there. Try typing this: 

BEHm 

Your program (lines 10 and 20) will be displayed on the screen. 
Now type RUN and the program will "run" again. 

9 



You have just been introduced to several aspects of the VIC 
that you will use in many of the later chapters. You have: 



( 

m 



m 
m 
m 



• PRINTed messages on the screen. 

• CLeaRed the screen (SHIFT CLR keys). # 

• Written your first program (VIC20) and created a moving 
display. 

• Slowed down (ConTRoLed) the program (the CTRL key). 

• STOPed the program with the STOP key (RUN /STOP key). 

• LISTed the program. 

• Learned some easy ways to edit what you type. 



As you explore the chapters of this guide, you will find many ^ 

uses for what you have seen here. Don't worry if you have 
unanswered questions at this point. Just go ahead and experi- 
ment and most of your questions will be answered as you go 
along. 



o 



# 



This guide is designed so that you can go directly to any 

chapter thsi\ looks interesting to you. You do not have to read 

each chapter in order to get to know your VIC. Just be sure to (~ 

start from the beginning of each chapter. You will find that our 

gradual introduction to each topic makes it easier for you to C 

learn how to create adventures of your own. Enjoy! ^ 
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Your First Graphic 
Character 

A Tour of the 
VIC 20 Keyboard 

Printing on the 
Screen 

The VIC 20 
Calculator 

Introduction to Color 



Try typing this program: 

Type this program exactly as shown and see 
what happens! 



10 PRINT 



20 FOR T=1 TO 300: NEXT 
30 PRINT "your name" 
40FORT = 1TO300:NEXT 
50 GOTO 10 



Type: [r] [u] [n] and hit 

To Stop the program, press the 




key. 
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USING THE SCREEN AND 
KEYBOARD 

This chapter assumes that you've read and understood Chapter 
1: Getting to Know Your VIC. If you have not, go back and read 
at least the last two sections which show you how to use the 
keyboard to control what the VIC prints on the screen. 

To start, poise yourself before the VIC keyboard and type as 
follows, including the program line numbers and punctuation 
marks: 



Hold down the ^j^^^ key and press the fTO^ key. 
[n] [Ej jw] and press the ^^^^^| key. 



m [SlimSEHHflJBB^ 



Bs" 



and press 

s ^[o]iT][o] m 

and press 




Rj [UJ [Nj and press 

When you type RUN, the screen should fill with the word: 

HELLO 

The words appear to be moving up and sideways! Press the 
CTRL key to slow things a bit. The VIC is PRINTing the 
message several times near the bottom of the screen. When 
the screen fills, the contents of the screen are moved up to 
make room for more PRINTing. So, the upward movement is 
really happening. The "barber pole effect" is an "illusion" 
caused by the number of characters the VIC is putting in each 
line. 

To stop this program, press this key: 



13 



Now, it's your turn. Type these two lines: 

hI^BbSE® mElH 1] E E [gfYouR 




and press 

D [U] [n] and press 



Wow! Now that you're a TV star, what does your name do on 
the screen? The "illusion" of movement depends on the 
number of characters in the message. 



Again, when you want to stop the action, press the 

YOUR FIRST 
GRAPHIC CHARACTER 



key. 



Clear the scree n (hold down WtKK^ and \iiliiii3 ). Now 
typs HPVIH A^D [Sj . You should get a blue heart on the 



screen. Try it again. You have just typed your first graphic 
character. 



Try typing other graphics. Now hold down the %iiM key and 
type some graphics — this is the left side graphics set. Left 
side graphics are very good for designing business forms, 

charts and graphs. Typing the ^^^H and t^ keys at 

the same time lets you use upper and lower case letters. See 
Chapter 3 for an explanation. 

SIZE OF THE SCREEN 

How big is the screen on the VIC? Let's find out. Do this: Clear 
the screen and type the following: 

d] [H [Wj and press 




U 1] lo] [t] [o] H 



C 
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The screen will fill with blue hearts! Count the number of 
hearts being printed across the screen. There are 22 of them in 
each row. The VIC has 22 PRINT positions across the screen. 
The positions across the screen are sometimes called columns. 
The VIC has 22 columns. 



How many positions are there down the screen? Press the 
key to slow down the PRINTing. Holding the ^Q key 
causes the last four rows to "flash". The VIC has 23 rows 



down the screen. 



COLUMN 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 
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The VIC has 506 places on the screen for characters, letters, 
symbols, and so forth. You might say that the VIC can juggle 
506 characters at the same time. Amazing! 



VIC TIP 

If the VIC has 22 columns across the screen, then any message whose 
length is an even divisor of 22 (messages 2 characters, 11 and 22 
characters in length) causes the VIC to PRINT in nice neat columns. 
Messages of other lengths spill over to the next line. Test this assump- 
tion for yourself. 



c 
c 
c 
c 



Stop the VIC'S PRINTing of the neat columns of hearts by 
pressing the Bifita key. Then enter these two tines into the VIC. 







( 
c 
c 
c 
c 



You can change the way information is printed on the screen 
by putting spaces between the quotation marks. Another way is 
to use periods (or dots) instead of spaces. Try typing your name 
and 3 periods in the program at the beginning of this chapter. 



c 

c 
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A TOUR OF THE 
VIC20 KEYBOARD 






You have now used the keyboard to create and PRINT 
messages, put graphics characters on the screen, control the 



flow of what the VIC is doing ( Iffltl and ^^ ). and 
possibly edit what you have typed ( 



Time now for an extended tour of the keyboard and what it can 
do for you. Consult the diagram above for the powerful and 
versatile set of VIC20 keys. 



RESTORE 



This is a "reset" key. 

If you type the RUN/STOP key and the ^^IHB key 
together, you completely reset the computer as if you just 
turned it on. ..with the benefit that any programs you had in the 
memory are retained and can be listed or run from the start. 
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SHIFT keys — The VIC keyboard is just like a 
typewriter and has two shift keys and a 
SHIFT LOCK key- The SHIFT key is used with 

other l<eys to type graphics characters and perform operations 

like clearing the screen. 

CLR-HOME key — Press this key and the 
cursor moves to the top left-hand corner of 
the screen (the "home" position). If you hold 
down the SHIFT key and press this key, the cursor still moves 
to the home position, but you also clear the screen. 

CRSR keys — With the VIC, you can easily 
move the cursor up, down and sideways. The 
CRSR keys have a repeat feature that keeps 
the cursor moving until you release the key. Each key has a set 
of arrows that tell you the directions the key controls — up and 
down or sideways. To move the cursor down or to the right, you 
simply press the appropriate key. To move up or to the left, you 
must hold down the SHIFT key while pressing the appropriate 
CRSR key. It is significant to keep in mind that you can move the 
cursor over the tops of characters on the screen without affect- 
ing those characters. 




RETURN 



RETURN key — You press RETURN at the 
end of each line of instruction. Pressing this 
key tells the ViC to enter the line, or to 
execute the instruction(s). Sometimes it helps to think of 
RETURN as an ENTER key because this key actually enters the 
information or instruction into the computer. 

CTRL key — This key is used with the 
COLOR keys to select the colors that you 
create on the VIC screen. The key also 
provides you with the ability to define your own control 
commands that can be incorporated into any applications you 
might develop for the VIC. Some plug-in cartridges will make 
use of the Control key to perform special functions. The CTRL 
key works like the SHIFT key. You must hold it down while 
pressing the color key. 
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BLK\/WHT\/RED 



ftS!!3o 

COLOR keys — You can change the colors of the characters 
displayed by simultaneously pressing the CTRL key and one of 
the 8 color/number keys on the top row of the keyboard. A 
shorthand notation for each color is shown on the face of the 
keys. The colors are black, white, red, cyan (light blue), purple, 
green, blue, and yellow. With these keys, you can set or change 
the color of letters, numbers and graphics displayed inside or 
outside a computer program. Once you "set" a color, everything 
you type will be in that color until you change colors again. 



nj^k RVS ON and RVS OFF keys — You can 
iiTOJtw rroiw f^vsrse the images that the VIC puts on the 
msSm^33e screen by typing CTRL and RVS ON. Every- 
thing you type will then be reversed... for example, you can 
make the VIC display white characters on a blue background 
(the opposite of what it normally prints) by pressing CTRL and 
RVS ON. To get back to normal type CTRL and RVS OFF. Try it! 

RUN-STOP key — Press this key to tell the 
VIC to stop what it is doing and return control 
back to you. When the VIC is running a 
program, you can stop the program with this key. Holding down 
the SHIFT and pressing this key, tells the VIC to begin loading 
information into memory from the optional tape cassette unit. 

INST-DEL key — You can insert and delete 
characters from the line you are typing by 
pressing this key. When you press the key by 
itself (delete), the character that was immediately to the left of 
the cursor disappears. If you're in the middle of a line, the 
character to the left is deleted and the characters to the right 
automatically move in to close up the space. Holding down 
SHIFT and pressing this key, opens up a space in the tine so 
you can insert a new character. This is very powerful for editing 
and correcting mistakes! 

GRAPHICS & THE COMMODORE KEY — 

When you turn on the VIC, you're 
automatically in "graphics" mode which 
means you can type UPPER CASE letters and the more than 60 
graphics you see on the keys. There are two graphics on each 
key. To get the graphic on the right side, simply hold down the 
SHIFT key and type the key with the graphic you want. To get 
the graphics on the left side, hold down the "COMMODORE" 
key (the little flag). In this way you can type UPPER CASE 
letters and the full graphics set at the same time! You can 
create pictures, charts, and designs by placing characters side 
by side or on top of each other (like building blocks). 
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UPPER/LOWER CASE and GRAPHICS keys — If you press the A 

SHIFT and COMMODORE keys at the same time, you put the 

VIC into a text mode. You can then use the VIC like an ordinary G 

typewriter, with full upper and lower case letters, plus all the ^ 

graphics on the left side of the keys. The left side graphics are * 

ideal for creating charts, graphs, and business forms. To get ^ 

back into "Upper Case/Full Graphics" mode, press the SHIFT 

and COMMODORE keys together. • 



? 



» 



» 
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PROGRAIVIMABLE FUNCTION KEYS — The C 

four tan keys on the righit side of the console r~. 

are not defined when you turn on the VIC. 
They can be assigned tasks or functions from C 

within the applications that you create. By 
using these keys with and without SHIFT, you 
get a total of eight assignable function keys. r~ 

Function keys will be mostly used with plug- 
in cartridges containing special programs, C 
but computer programmers can assign these 
keys as well 



c 



c 



SPECIAL KEYS — The VIC keyboard also contains special 

symbols not found on many typewriters, or even most 9 

computers. Examples are the English "pound" sign ( £ ), pi ^ 

{ TT ), back arrow ( ■< — }, up arrow ( f ), greater/lesser than ^ 

( > < ), and brackets ([ ]) ^ 

This concludes your tour of the VIC keyboard. Using only 9 

words, it's difficult to convey just how flexible and powerful the r 
VIC keyboard is. The best way to discover everything the VIC 

can do is to begin your own "touring". Experiment with the ^ 

keyboard. Try out the various upper/lower case features _ 

mentioned above. See what you can create with the rich VIC w 

graphics set. The keyboard is your direct link to the VIC. a 
Knowing the Keyboard will help you know your VIC 20. 
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Clear the screen and enter the following lines: 

new! 



The screen shows: 



PRINT "A", "B" 




Now, enter this line and press 
The screen now shows: 



PRINT "A"; "B" 



NEW 
READY 
PRINT "A", "B" 



READY. 
PRINT "A"; "8" 



READY. 
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When the comma was used in the first PRINT statement, the 
VIC placed the letters on the screen, but separated them by 
several spaces. When the semicolon was used, the VIC 
displayed the two letters close together. 

In the first case, the letters are exactly 11 spaces apart. That 
fact gives a clue to what's happening. The VIC divides the 
screen area into two equal parts. 

Whenthe VIC is PRINTing two messages or numbers separated 
by a comma, it puts the first item on the left side of the screen 
and the second on the right.. 




UNLESS 



The first item is longer than 11 characters. 

If the first item is less than (or equal to) 1 1 characters, the VIC 
PRINTS it and then moves to the center of the screen to display 
the second item. If the first item is longer than 11 characters, 
the second item appears on the next line. Clear the screen, and 
try this example: 

PRINT "ABCDEFGHIJKL", "X" 
The screen will show: 



c 
c 



c 
c 




The first part of the message is 12 characters long, so the "X" 
ends up on the next line. Repeat this example with a semicolon 
(;} between the two items. 
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PRINT "ABCDEFGHIJKL"; "X"' 
Does your screen show this result? 




Get the idea? The VIC acts like a typewriter with an automatic 
tab set near the screen's center. Wtien it sees the comma, it 
either "tabs" to the center of the screen or the beginning of the 
next line, whichever is next available. 

Clear the screen and type the following line into the VIC: 

PRINT 1,2 

The screen shows: 




Do you see the space in front of the first number? When the 
VIC displays numbers, it leaves a space at the beginning for the 
sign of the number. If the number is positive, you see a blank 
space. If the number is negative, a minus sign (-) would appear 
on the screen. 
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Try it and see. Enter this line into the VIC: 

PRINT -1,-2 
Look at Ihe screen and see what is displayed. 




The numbers appear in the same places as in the previous 
example; they are preceded by the minus signs {-). 

These few examples give you some idea of how the VIC can 
help you get your messages and information on the screen. The 
VtC has many other ways to assist you with this task, and you 
will learn what they are as you continue to use your new 
computer. 



The VIC Calculator 



The VIC can also be used as a 9 digit calculator. The + and 
- sign are used just like in mathematics. The VIC multiplica- 
tion sign is the asterisk (*) and the division sign is the slash 
(/). Type these calculations and check the results. See Appen- 
dices C and K for more information. 



PRINT 1-fl 




PRINT3-2 
PRINT 5*2 



PRINT 6/3 



If you PRINT a calculation you 
should put it outside the quota- 
tion marks. Try these examples 



1 PR)NT"2*(4/2)" 

1 PRINT'THE ANSWER IS"2*(4/2) 



c 

c 
c 
c 

c 

G 
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INTRODUCTION 
TO COLOR 

The VIC can print letters, numbers and graphic symbols in 8 
different colors. It can also print characters in reverse. 

With the screen cfear, hold down the CTRL key and press this 
key: 



9 



Now let go of the CTRL key and put your finger on the SPACE 
bar at the bottom on the keyboard. Hold the SPACE bar down. 
What happens? Is there a blue line being drawn across the 
screen? 




Hold the SPACE bar down as long as you want. As the cursor 
disappears off the right edge of the screen, it reappears on the 
left and the blue line starts forming a larger blue color bar. 



Release the SPACE bar and do this: 



Hold down the CTRL key and press the RED key. 



The cursor should now be red. Press and hold the SPACE bar 
once again. Does a new red color bar start to form? Yes! Well, 
keep painting! 
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Change to other colors as you feel like it. Make the color bars 
as thick or thin as you like. Enjoy this newly discovered ability 
of the VIC that puts a little color into your life. 



c 
c 

C' 

m 
m 



Now, type 




and hit the space bar 




Nothing happens except blank spaces. Type 



and the color bar reappears. Try typing some letters 

in "reverse". Reverse letters make excellent headlines and are 

often used to highlight special words and numbers. You can 

also use reverse characters inside a program. For example, try 

this: 

NEW 




VIC20"; 



10 PRINT " 
20 GOTO 10 
RUN 



To get ready for the next chapter, type 

and type the word NEW and 





c 
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Programming in 
Color 

The VIC Color Keys 

Changing Screen 
and Border Colors 

Screen and Border 
Color Combinations 

Coloring the Screen 

Screen Locations 

Random Colors 

Combining Sound 
and Color 

Keyboard Graphics 

Graphics in 
Headlines and Titles 



Try typing this program: 

Type this program exactly as shown and see 
what happens! 




To stop the program, press the 
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COLOR & GRAPHICS 



The VIC and your color TV set give you the ability to put 
colors everywhere on the screen. When you first turn on the 
VIC, the border, the cursor, and any characters on the 
screen are already in color. But that's only the beginning. 
The VIC can display 8 cursor colors, 8 border colors and 16 
screen colors! 

Let's start by using the keys on the VIC'S keyboard to make 
colors on the screen. Type any letter. The letter should 
appear in dark blue on a white screen. Now look at the top 
row of keys {the numbered keys from 1 to 8). Do you see 
the color names written on the front of each key? Now find 



the key marked ^^ on the left side of the keyboard. 
Hold down the Bf!i key and hit the key marked , 



Release the ^Q and AhA keys and type any letter 

on the keyboard. This letter should appear in yellow. Now 

hold down the fSHi key and hit another color, then type 



some letters. See how easy it is to change letter colors on 
the screen? 



Now find the key marked mSm. Hold down the ■■ key 
and hit the M^L. . Try typing some letters. All the letters 
you type (until you hit the ^^^^^H key) appear in 
reverse on the screen, like a photographic negative. If you 
hold down ^Q and hit mS^ , the tetters you type will be 

displayed normally. 
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PROGRAMMING IN COLOR 



Now let's combine color control with a simple program 
command. Note that when you type ffiB and a color key 



inside quotation marks, a reverse graphic symbol appears. 
This is okay. Do this: 



Hold down the 



Type the letters: 



key and press the 



key. 



NJ [EJ [W) and press the 



key. 



Then type: [T] [E [E Q S [D Q 




and press 



Type: L2 



GOTO 



m 



and press 
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If you have trouble typing this exampie, flip back to the 
section called "Getting Started" in Chapter One. You can't 
hurt the VIC with anything you type, but you can get 
confused by certain key combinations. If you accidentally 



leave the ffjijff key engaged, for example, the resulting 
display is difficult to decipher. If you make a mistake, hit 

a few times and retype the entire line. The 



new line will automatically replace the old one. When you 
have the two lines shown above on the screen, type: 



RUN and press 



As soon as you press that final 



, you should 



see hundreds of red and blue balls float by on your screen. 
How? It's easy with the VIC. Look back at the example 
above. See the two strange characters in the line that begins 



with "1"? They were created when you held the ^^ key 

and pressed the ^^ and ^& keys. The symbols that 

appear are VIC's shorthand to tell it to make the first ball red 
and the second one blue. 




and press 
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Nothing to it. When you are tired of red and blue, press 
STOP. If you like free form exploring, try retyping line 1. 



Throw in some 



and color keys along with graphics 



characters and letters or numbers. The VIC can handle it all 
and will give you an enlightening color display. 



THE VIC COLOR KEYS 

In the last example, you discovered that you can insert color 
controls Into a PRINT message by using the ^ffl and the 
keys whose faces are labeled: 



E!A EBA aSH Hf^ Bffy IHSH IWft JHl 



These keys are the number keys 1 through 8. When you 
press these keys in the middle of a PRINT statement, a set 
of "strange" characters appear. To see what these 



characters look like, press |^ (if the program is still 
running), clear the screen, and enter: 

PRINT 




^Q ^Q ^^ ^^ ^^ ^^ ^^ ^Q 



Don't forget to put in the quotation marks or to use the 
key with the color keys. Your screen should show: 
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PRINT 



a]SCI]B[n][][1I1[o]B[w10[I] 







R IN BOWS 



READY. ^ 



^ix 



Where is the letter "A"? Oh! The second color key is 

and the background is . . . you guessed it . . . white. 
PRINTing a white letter "A" on a white background gives 
you a space in your RAINBOWS. 

The other seven letters in the word RAINBOWS are eacti a 
different color. The last letter, S, is yellow. Note that ttie 
READY message is also in yellow, along with the cursor. 
When color controls are put in PRINT messages, the VIC 
remembers the last color used and stays in that color. 

To change the cursor back to the regular blue color, hold 

down ^ffl and press ^^ft . If you wish, try PRINTing 

some color messages on your own. You will get a chance to 
see more uses for the color control keys in just a bit. Right 
now, there is an important announcement . . . 



EXTRAI! EXTRA!! 

The VIC Color Show is on The Way! 
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CHANGING SCREEN & BORDER COLORS 



Now that you know how to change the colors of letters and 
graphics, we're going to show you how to change the screen 
and border colors. You can display 255 different screen and 
border color combinations. To make sure the VIC is ready for 



what comes next, press 



gyQl 



and then 



to 



erase the screen. Next, type these lines into the VIC: 



NEW 



and press 



(Press ^minill^H at the end of each of the 
following lines.) 





1F0RX = 1 TO 255 



2P0KE 36879, X 



3PRINT " j^ POKE 36879," X 



4F0R T = 1 TO 1000: NEXTT 



5NEXTX 
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When you have typed these lines, look them over and see if 
they match what is shown on this page. If there are some that 
don't match, retype those lines from the beginning. Use 



the 



to move back to any lines you want to retype. 



Once you are satisfied that the lines are all right, get a piece 
of paper and a pen or pencil and place it nearby. Ttien type: 



RUN and press 



Your screen should begin to blush and flash. The border 
changes colors. The background changes colors. Even the 
small message at the top of the screen is changing colors. 
The VIC is displaying 255 different color combinations. 
(Syntax error in one of the lines? Retype that line and 
then type: 



rm ful rNl and 



again.) 



While the VIC is running, if you notice a particular set of 
colors that look interesting; write down the number of that 
combination. Only the number at the end of the printed 
message is changing. The "POKE 36879," stays the same. 
(Occasionally, you will not be able to read the message 
because it is the same color as the background. C'est la vie. 
The letters and numbers will reappear after a few additional 
flashes.) The VIC has eight border colors, sixteen 
background colors, and eight character colors. You can put 
characters in all eight colors over any background. That 
gives you a lot of combinations to explore. 

If you want to restore the screen to its original colors, simply 
hold down the BiSl key and hit 



Line two in the example above is responsible for making the 
VIC change colors. The line contains a POKE command. 
Every POKE command has two numeric values that the 
VIC uses: 
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The first number (in this case, 36879) is the location in 
memory (think of it as a tittie box labeled 36879) into which 
you are going to POKE (ie. place) the second number, X. The 
memory location 36879 happens to be where the VIC stores 
its information on what the screen's border and background 
colors should be. Each value of "X" corresponds to a 
different color combination the VIC can display. For this 
example, "X" starts with the value 1, then changes to 2, 3, 
and so forth, up to a final value of 255. 



] 


/ 


1 




/ 


Memory 

Location # 

36877 


^ 



Memory 

Location # 

36878 





Memory 

Location # 

36879 



AN EXAMPLE OF POKE 36879, 8 
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To assist you in your quest for the perfecf color 
combinations, here is a table of POKE values ("X" values) 
and the background and border colors they produce. The 
table gives you the POKE values to produce all combinations 
of these colors. The POKE values are in sequence with skips 
of eight (8) numbers. The missing numbers are the POKE 
values that cause the reversal q\ displayed characters. 
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SCREEN & BORDER COLOR COMBINATIONS 











Border 










BLK 


WHT 


RED 


CYAN 


PUR 


GRN 


BLU 


YEL 


Screen 


















BLACK 


8 


9 


10 


11 


12 


13 


14 


15 


WHITE 


24 


25 


26 


27 


28 


29 


30 


31 


RED 


40 


41 


42 


43 


44 


45 


46 


47 


CYAN 


56 


57 


58 


59 


60 


61 


62 


63 


PURPLE 


72 


73 


74 


75 


76 


77 


78 


79 


GREEN 


88 


89 


90 


91 


92 


93 


94 


95 


BLUE 


104 


105 


106 


107 


108 


109 


110 


111 


YELLOW 


120 


121 


122 


123 


124 


125 


126 


127 


ORANGE 


136 


137 


138 


139 


140 


141 


142 


143 


LT. ORANGE 


152 


153 


154 


155 


156 


157 


158 


159 


PINK 


168 


169 


170 


171 


172 


173 


174 


175 


LT. CYAN 


184 


185 


186 


187 


188 


189 


190 


191 


LT. PURPLE 


200 


201 


202 


203 


204 


205 


206 


207 


LT. GREEN 


216 


217 


218 


219 


220 


221 


222 


223 


LT. BLUE 


232 


233 


234 


235 


236 


237 


238 


239 


LT. YELLOW 


248 


249 


250 


251 


252 


253 


254 


255 



COLORING THE SCREEN 

Time to combine the VIC'S color and graphics features in a 
deiightfui color display. Again, you only have to enter a few 
lines into the VIC, and spectacular events begin to happen. 

If any examples are still flapping or bouncing across the 
screen, ^^ them. Clear the screen. Then, type these 
mysterious lines: 



n] [e W (not too mysterious, yet) 
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1 L = INT(RND(1)*500) + 1 



2 C = INT{RND(1)*8) + 1 




3 POKE 7680 +L, 160 





4 POKE 38400 + L, 




c 
c 
c 
c 

c 

c 
c 
c 



5 GOTO 1 



C 

c 
c 
c 



Check Ihe example to see if all the lines were typed as 
shown. If they are all right, clear the screen and type 

Your screen should explode in tiny bursts 



RUN 



of color. 

The VIC has done it again! With only a few keystrokes, it is 
now dabbling color everywhere. How is this being done? 



In simple terms, lines 1 and 2 are randomly selecting where 
on the screen the color will go (L for Location maybe) and 
what color (C for, of course, Color). Line 1 generates a 
number from 1 through 500. Line 2 generates a number from 
1 through 8. 



C 




Line 3 POKEs a character onto the screen. 
The value 7608 represents the home position 
on ttie screen; the top lefthand corner. 
The POKE value 160 is a solid blocit 
(essentially a reversed space). 

Line 4 POKEs the color onto the character. The value 38400 
represents the location in memory of the color component of 
the character in the home position. 



SCREEN LOCATIONS 



VIC TIP: 

To POKE characters on the screen, you must POKE the screen 
location and the color at that location for each character. The screen 
locations start at 7680, The color locations begin at 38400. See 
Appendix for the screen memory map. 



You Should try POKEing other values onto the screen. 
Change the 160 in line 3 to any number from to 255. 

EXPERIMENT^ and enjoy your VIC's colorful personality. 



There are 506 possible screen locations (chart). You can 
place any word, letter, sentence, graphic, or whatever — 
whenever you want on the screen. Just imagine the screen 
consists of 506 boxes lilte this — each box has a number. 



Enough POKEing around! Time to get back to the color 
control keys. 
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VIC TIP: 

To restore your VIC to its normal border and background colors 
type this POKE statement; 



POKE 36879, 27 
or hold down the RUN/STOP key and hit 



RANDOM COLORS 



C 

O 

c 
c 



c 



You are now going to find out how you can fet the ViC 
choose colors to put on the screen. First clear the screen, 

and type these lines (press ^^^^^| after each line): 




1 PRINT " H ^^j B r9 



2 GOTO 1 



RUN 



^ ; 




( 
C 

C 
( 

c 



Your screen should fill with red and bfue birds. Wonder 
where they are flying to? They are really moving. 
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Let the birds fly for a while. When you want to stop their 
flight, press H 



Now that you know how to create birds, clear the screen and 
type these lines: (Remember the ^^^^^| ) 



[n] jj] 
1 A$ = " 



BEaBElllQQ 



2 N = INT(RND(1)*8) + 1 ^ 




4 PRINT B$ " \-»-' r9-\ "; 




5 GOTO 2 

Look the lines over once they are entered. Check to see if 
they match what is shown above. When you are ready, clear 
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the screen and type [r| [u] [n] ■ '^ VOiJ ^^^^ ^nv errors, 

retype this problem line and [^ [0] [n] it again, Sam 

(excuse us, VIC!!). Birds! Birds! Everywliere!! in every color 
of the rainbow! Your screen should be humming (oops!) with 
flocks of "rainbow" birds. Notice that there are gaps in your 
flock. Actually, the VIC is PRlNTing white birds in those 
places. If you want these "invisible" birds to appear, you 
must change the background color. (Remember how? You 
POKE a number into location 36879.) 

Of course, If you change the background to another color, 
say blue, then all the blue birds will disappear. Try it and see 

for yourself. Press ^M when you want to keep the birds 
from flying. ~" 



c 
c 
c 
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The last example used some interesting VIC features to get 
the birds on the screen and change their colors. Let's look 
at the example line-by-line. The first line is; 



1 A$ 



llSBailSEIl 



The color controls form a long string of characters and 
are put into the VIC's memory in a place called AS 
(pronounced "A string" or "A dollar sign"). You can think of 
A$ as being like a box where strings of characters can be 

stored. The first position in the box AS contains thej 

control character. The last position contains the 

control character. 



% 



^^/jnoO 





s 



c 

c 
c 



c 
c 
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The next line is: 

2 N = INT(RND{1)*8)+ 1 

This line generates a random positive whole number from 
one through eight and puts the number into "N". "N" is the 
place in the VIC's memory that can be used to store 
numbers. The VIC knows that "N" is a place to store 
numbers since there is no dollar sign ($) at the end of 
the name. 

In line one, the location used to store the color controls was 
called A$, and it has a dollar sign on the end. The VIC knows 
that locations whose names end with a dollar sign are to be 
used to store messages or strings of characters. 

For more Information on how [J] [E B and [r]' [n] work 

together to generate random numbers, look at Chapter 
Seven in this book. For now, just be aware that this line is 
producing numbers from one through eight. See the number 
eight on the right side of the equal sign? That number 
controls how many random numbers are being generated. If 
you were to change the eight to a six, then any number from 
one through six would be produced. 

Hmmm . . . moving right along now: 

3 B$ = MID$(A$,N,1) 



This line creates a new box called B$, and puts one color 
control character into it. AS contains all eight color control 
characters. "N" is a random number from one through 
eight. V\/hat does MID$ do? It picks out one color control 
character from AS at the "N"th position in the string. This 
character Is put into B$. Yes, "Virginia", now we have three 
little boxes inside the VIC, one called A$, one called "N" 
and one called B$. Each time the VIC gets to line two, it is 
given a new value for "N". This determines which color MID$ 
picks and puts into B$. 



A$=BQElK[]nSEil 
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The fourth line is: 



4 PRIMT B$ " v.0^ ^^^ >. 



This line tells the VIC to use the color it finds in the B$ box 
and to draw the birdlike creatures with it. The command, 
PRINT B$, creates the same effect as typing a specific color 
control character. By using B$, however, we can have the 
VIC change the color character automatically. As "N" (line 2) 
changes, B$ changes (line 3), and the birds change color 




\^ 



A 






f( 



The VIC'S ability to generate random numbers can be 
combined with its color, sound, and graphics features in 
many interesting ways. For example, let's revisit the VIC 
Color Show, but randomly, and make some noise while we 
are at it. 
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In this last example, the VIC's color and sound are 
both randomly produced. Enter the following lines into 
the computer: 



NEW 



1P0KE 36878, 3 



2C = INT(RND(1}*255) + 1 




3S = INT(RND(1)*50) + 175 i: 




4P0KE 36879, C 



5P0KE 36875, S ^ > piay note. ) 

6F0R T = 1 TO 100: NEXT T ^::,_ C Walt. ^ 

7G0T0 2 



The bubble captions tell most of the story on this example. 
Chapter Five tells you more about music. If you are ready to 

run the example, clear the screen and type [W| [u] [n] , then 

press 
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/ / / 



My, my!! What a wild bunch of sound and color 
combinations. Oh, well! You get what you play. You can't 
expect random music to be to everyone's taste. 

When you want to halt this color and sound machine, press 
Then you need to type these two lines to shut off the 

note that is still playing and restore the VIC screen to its 
normal colors: 



POKE 36875, 



POKE 36879, 27 



r Stop T 
< — ■ — \y note. ) 




Time for you to explore on your own. Experiment with the 
VIC'S colors. Enjoy your colorful, musical VIC computer. 



c 
c 

( 

c 
c 
c 
c 

c 
( 

( 

( 
( 
c 

% 

( 

•-' 

t' 
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KEYBOARD GRAPHICS 



One of the special features of your VIC 20 is tfie graphics 
keyset. Most of the l<eys have two graphic characters printed 
on the front. You can display these graphics on the screen, 
or, if you have a Commodore dot matrix printer, print tfiem 
on paper along with all the other keyboard symbols. 

To display the graphic on the left side of the key, hold down 
the Commodore key while pressing the graphic key, to 

display the right side graphic, hold down the ^^^| key and 

type the graphic you want. 



VIC TIP: 

Caution... if you push both trie SHIFT and Commodore keys at the 
same time, you will switch to upper/lower case mode. In upper^lower 
case, oniy the left side graphics are available. To get back to upper 

case/graphics mode, push ^^^| and Q 'osether. 



The easiest way to use VIC graphics is to type the 
COMMODORE g or ^^^| key, and the graphic symbol 



you want to display from the keyboard. For example, type 
the following: 



You should see a blue rtearf printed on your screen. Try 
typing some other graphic keys. Here are some other keys 
you might want to try: 



47 




Left Side G 


raphics 


Right Side Graphics 


B 


B 


^^^^1 Q 


S 


f@l 


^^^H w 


S 


l±J 


^^^9 


ra 


iBj 


^^^H 



c 
c 
c 
c 
c 
c 
c 
<: 
c 



Notice that the left side graphics are good for creating 
charts, graplis and business forms. Right side graphics 
are good for drawing illustrations, animations . . . even 
playing cards! 



GRAPHICS IN HEADLINES & TITLES 



and the 



Graphics aren't limited to cartoons and games. You can use 
a variety of special effects to enhance titles in charts and 
graphs, or highlight special words in programs that use a lot 
of text. The easiest way to highlight a word or phrase is to 

type it in REVERSE. Simply type 

word you want. 

For example: 



[imEEE 



S a [d] E □ [n] B Q 



Type a 

headline using_ 
the keyboard. 
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HEl] 



C 

c 
c 
( 
c 
c 
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( 
c 
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Now try some spaces to create a title bar 

d E U D] S S Q 




Another way to highlight a word is to draw a graphic box 
around it. The technique is like drawing. Be sure to type 
exactly as shown. Let's do it step by step. 



[E m [n] E"H ^ H [il a [i] S [i] H 



10 P 



RUN 




The screen will show a straight line. The next line includes 
your headline and a vertical line at each end to complete the 
sides of your "box". 



1 H [D E E Q 




I3[g] [AlaiclHyH 



lEMM 



See how we are building the headline box? Now to finish 



RUN 




VIC TIP: 

To edit your program, type LIST and press RETURN. Now you can 
go bacK and change a line thai isn't exactly right, by using the CRSR 
and INST/DEL keys to move Ifie error and retype it. After you make 
a correction or change, press RETURM to enter the change (or that 
line . . . or . . . you can also retype any line any time and press 
RETURN to change it. 



l-lere's another way to highlight a word or headline, by 
animating it so it appears to blink several times when it 
comes on the television screen . . . 



Ui^ LE^ W 



10 FOR H = 1 to 250 




20PR1NT " 

25FORT = 1 TO 50: NEXT 

30PRINT " ^^1 g g ^ 

EI B [d] B m :[1" 



[h] d [a] [D] B H S E" 



c 
c 

c 

c 

C 
C 

c 



r 

c 

c 

c 

e 

c 

c 



35FOR T = 1 TO 50: NEXT 



40NEXT H 



R UN 



If the headline doesn't overlap evenly, try adjusting the 
spacing inside the quote marks. To speed up or slow down 
the blinking change the number in lines 25 and 35. 
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Try typing this program: 

Type this program exactly as shown and see 
what happens! 



10 PRINT" 

20 PRINT " FT) lOl [71 " 

30 PRINT " □ ^ CH " 
40 PRINT " nH S " 
50 FOR T = 1 TO 300: NEXT 
60 PRINT " H "; 

70 PRINT " 1^ 

80 PRINT " ^ S " 

90 PRINT " r~i n n " 

100 FORT=1TO300:NEXT 
110 GOTO 10 



To Stop the program, 
press the CS9 key. 
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FLYING BIRDS 



This chapter shows you how to use the VIC'S graphic abilities 
to create illusions of characters moving about the screen. 

The illusion of movement you can create with the VIC is often 
referred to as animation. Animation can make any program — 
from games to business programs — fun and exciting. 



Let's begin by entering the following lines: 
Hold down the B^^l key and press the 



key. 



[n] [e1 and press the 



key. 




^ 



To get birds 




HOLD 


PRESS 


v.^^ ^^^fl 


[T Q K 


f9'\ ^^^H 


E] Q] [Q 


For more on ' 


BIRDS" see 


Chapter 3, * 


Graohics" 



a ss mm mmm (n s h m 



and press 

[HHiiBP R I N T "g r»^ 



and press 

m EE Ell] m[Dm b s am 




and press 

\5] 




mmmm 



m 
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WHAT YOU HAVE JUST TYPED 
SHOULD LOOK LIKE this: 



1 PRINT" @ '-•-'" 

2 FORT = 1TO150;NEXTT 

3 PRINT " @ ''••> " 

4 FORT=1T0150:NEXTT 

5 GOTO 1 



Look over what you have typed. Does it match what is shown? 
If it does not, re-enter the lines that are different. When 
everything matches, type: 

[r] [H] [n] and press 



HINT: You can re-enter or change any line by typing it over. The 
second typing will automatically erase and replace the 
first. You can erase a line by typing the line no. only 

followed by 



Befiold your first VIC illusion or animation. The "bird" creature 
is huffing and puffing up in the top left-hand corner of the 
screen. It seems to be using a lot of wing power, but tfiere must 
be a strong headwind. The bird is getting nowhere. 




You, however, are getting places. Can you see how the bird 
appears to be actually moving its wings? Study the example for 
a moment. The secret to almost all animation on the VIC is 
given in this one example. How you can create this illusion of 
movement is easily described in a few simple steps. Here is a 
brief summary of how to make just about any character wink, 
blink, wave, nod, seem to move, and so forth. 
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c 

c 

c 

( 

( 

c 

c 

c 

c 

c- 

# 

c 

c 

c 



( 

( 

c 
c 



First, display the character or combination of characters in one 
position on the screen. 




Second, wait for a short period of time. A FOR-NEXT "time 
delay loop' makes this happen. Examples of "time delay" 
instructions are shown in lines 2 and 4 of the flying bird 
program. These lines tell the VIC to count from 1 to 150. The 
VIC can count to 150 quickly. Try changing 150 to 500 (or some 
other number) and see what happens. 

Third, display the character again but with some part of it 
altered. Because of the previous delay, your eye is fooled and 
you think you have seen 
"movement". 




Fourth, wait again. Based on what effect you are trying to 
achieve, this wait may be longer or shorter than the first delay 
loop. In the example, the delays between PRINTings were the 
same. 

Fifth (the easy part), repeat the first four steps just mentioned. 
This is accomplished by the GOTO command which tells the 
VIC to go back to the first line and start over again. Thus, the 
program prints the bird with his wings "up", counts to 150, then 
prints the bird with his wings "down" and goes back to the 
beginning again. 

In the first and third steps, where the character is being 
displayed, it is often necessary to make sure that no old 
character parts are left on the screen. In our bird example, this 
problem is taken care of by putting the screen clear character 



( 



and 



in each message. That character 



clears the screen and homes the cursor so each version of the 
bird (wings up, wings down) appears in the upper left-hand 
corner. 
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You may want to experiment with this example some. 
Press IKS to stop the wing flappings and change the upper 



counting limit (150) in lines 2 and 4. Try changing just one 
value, leaving the other at 150. Does your bird begin to soar? 
Try a value like 50 in both places. Does your bird fly faster? 
What about an upper limit of 500? 1000? 



Hmmm...the bird gets rather s-l-o-w 




CLeaR Out for HOME 



You already know that you can clear the screen by holding 
down B^^l and pressing the K^ key. From within 



a program, you can tell the VIC to clear the screen. You do so 
by typing: 



PRINT 




When you are entering a PRINT message, if you press the two 
keys ( Hi^l and |^|!)| ) that you use to clear the 



screen, the reverse heart image appears on in the message 
field. That symbol is a signal to the VIC that when the message 
is PRINTed, the screen is to be cleared at that place in the 
message, and the cursor sent home. Home is the upper left- 
hand corner of the screen. 




c 
c 
c 
c 
c 



c 
c 



G 
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Try the PRINT statement directly. Type it into the VfC. Does the 
screen clear? 

( Yes I 

Type: PRINT " g ■■; < -^ Works in the 

immediate mode 



Now, mess up the screen. Put some birds, characters, numbers, 
and graphics symbols all over the place. When your screen is 
sufficiently full, type this line; 

PRINT" EU "; 




Did you notice a difference from before with the other PRINT 
statement? Yes, this time the cursor went home but the screen 



did not clear. If you don't press the ^^^H key while typing 
into the message field, the reverse S image appears 



instead of the heart. The reverse S tells the VIC to home the 
cursor, but do not erase the screen. 




BOUNCING BALL 

Clear t he screen an d enter the following into the VIC: 
(Press ^^^^^H after typi^ng each line.) 

NEW 
1 PRINT 




2 GOTO 1 

RUN 

When RUN is typed, the screen should fill with columns of blue 
balls. Let the balls flow by for awhile and then press ^^ . 

Pressing pUrli causes the BREAK and READY messages 



to appear. Now, type 

1 PRINT ":, [r] • H "; 





The two reverse image characters are the symbols the VIC puts 
in a message field when you hold down (^ and press 



the 



£B and ^ 



keys. 





I RVS OFF J 



After you have typed the new line, tell the VIC to RUN this 
example: 

Type: RUN 

What happened to the balls? Press the ^Q key to slow 

down the PRINTing. There are now columns of blue rectangles 
with white holes in them. Can you guess why? 
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Putting the RVS ON control ctiaracter in front of tlie ball 

symbol, causes ttie VIC to reverse the colors being used to 
display each ball. The ball is normally blue and is surrounded 
by white background. The reversal made the background blue 
and the ball white. 




Placing the RVS OFF control character after the ball, tells 

the VIC to reset the reversing of background and character 
colors. That is like reversing the reverse, and you end up back 
where you started. If the RVS OFF is not used, an 
interesting effect is produced. 



f?ffl 



the reverse balls if need be, and enter this line: 




1 PRINT" T [RJ • "; ^-V 

Type; RUN ^-"^-^^^-v,.^-^ 

When RVS OFF is not used, all the spaces on the screen 

are reversed and become solid biocks. What an interesting 
pattern maker the VIC can become. How about designing your 
own textiles, or wallpaper, or floor tiies with the VIC? What can 
you think to do with the VIC? 
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THE CURSOR KEYS 

The four cursor control keys let you move the cursor anywhere 
on the screen. You can put the cursor controls in PRINT 
statement message fields to help you position the characters 
and messages you are printing. Here is the bird example from 
the beginning of the chapter with the addition of a few cursor 
controls. 

Clear the screen, and enter this new bird display: 



NEW 

1 PRINT" sm^^^mmm"; 





This line uses several cursor controls ( DOWN , RIGHT , 
LEFT ) to animate and move the bird image. You will see the 
movements when you RUN the entire example. 

2F0RT==1 TO150: NEXTT4 — ) Wait^ 
3 PRINT " r^'^ [DmCD "; 

This line contains three LEFT cursor control characters. 
4F0RT = 1 TO 150: NEXTT 

5 PRINT ■■, , [DEDQ] "; *-f ^^33®^ '^'''^ 





3 spaces 



6 FOR T = 1 TO 150; NEXTT 

7 GOTO 1 






c 

c 
c 

c 
c 
c 
# 
c 
c 

c 
c 
c 



60 



Type and check the example against the printed text. When you 
are ready, type RUN and watch the birdie. 





The cursor control characters in this example moves the bird 
down and across the screen. Easy as bluebird pie! 

Your turn again; why don't you invent another creature and 
m-o-v-e it across the screen. 



ANIMATING WITH 
POKES AND PEEKS 

So far you have learned to use the PRINT statement with the 
cursor controls and the color controls to nnove objects around 
the screen. This is probably the fastest way to move objects 
using BASIC, but it is not the smartest. Most arcade-style 
games require that the object moving around the screen reacts 
to other objects on the screen. The only practical way to 
program this is using the PEEK and POKE statements. 

In order to use this technique, you must first understand the 
concept of memory-mapped video. Each position on the screen 
corresponds to a location inside the ViC's memory (RAM). 
Since there are 506 possible positions on the screen for 
characters, there are 506 locations in memory to hold the 
characters. And, since each location in memory can contain a 
number from to 255, there are 256 possible values for each 
memory location. These are the 256 different characters that 
the VtC can make (see Appendix H). A number in a position in 
screen memory is a code for the character in that position. 

Screen memory in the VIC normally begins at location 7680, 
and ends at location 8185. Location 7680 is the location of the 
upper left corner of the screen. Location 7681 is the position of 
the next character to the right of that one, and so on down the 
row. The next location following the last character of d row is 
the first character of the next row down. 
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Now let's say that we are controlling a ball bouncing on the r 
screen. Ttie ball is in ttie middle of thie screen, column ten and 

row ten. (Ttie upper left corner is column zero, row zero.) Ttie ( 

formula for calculating thie memory location on thie screen is: ^ 

P-7680 + X + 22-Y ^ 

where X is the row and Y is the column. Therefore, the memory % 

position of the ball is 7680 + 10 + 220, or 7910. Clear the screen ^ 

and type: " 

POKE 36879,8 * 

• 

This changes the color of the screen to all black. Now type: ^ 

POKE 7910,81 ^ 

A ball appears in the middle of the screen! You have placed the C 

character directly into screen memory without using the PRINT ^ 

statement. • 

The ball that appeared was white. However, there is a way to ^ 

change the color of an object at any location on the screen, 9 

also using POKEs. Type; f- 

POKE 38630.3 Q 

The ball's color changes to cyan. For every spot on the VlC's w 

screen there are two memory locations, one for the character ^ 
code and the other for the color code. The color memory map 

begins at location 38400 (top left-hand corner), and continues % 

on for 506 locations. The color codes from to 7 will give you ^ 

the 8 colors numbered 1 to 8 on the keyboard. (Other numbers " 

will give strange-looking results. See the VIC Programmer's m 
Reference Guide for a complete explanation.) 
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SCREEN MEMORY MAPS 



This is 

location 

7681 



.This is 
memory 
location 
7680. 

.This one 
is number 
,7702 

Location ■ 
7910 
(a ball) 



CHARACTER CODES 
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Here is a short program to bounce a ball around ttie screen, 
followed by a detailed explanation. 



10 PRINT" ggg igg ■' 




20 POKE 36879,9 




30 POKE 36878.15 




40 X = 1 




50 Y = 1 




60 DX-1 




70 DY = 1 




80 POKE 7680 + X + 22*Y, 81 




90 F0RT = 1 TO 10: NEXT 




100 POKE7680 + X + 22*Y, 32 




110 X-X + DX 




120 IFX-0ORX = 21 THEN DX = 


-DX: POKE 36876. 220 


130 Y-Y + DY 




140 IFY = 0ORY = 22THEN DY- 


'DY: POKE 36786, 230 


150 POKE 36876, 




160 GOTO 80 





c 

# 
c 

c 



Line 10 clears the screen, and line 20 sets the color of the ^ 

screen to black with a white border. Line 30 sets the loudness 

of the sound generators to the loudest level. C 

The X and Y variables used in lines 40 and 50 keep track of the ^ 

current column and row position of the ball. The DX and DY ^ 

used in lines 60 and 70 are the horizontal and vertical direction 

of the ball's movement. When a + 1 is added to the X value, the C 

column is moved 1 to the right. When -1 is added to X, the 

column of the ball is moved 1 to the left. + 1 added to Y moves 



c 



the ball down a row, and -1 added to Y moves the ball up a row. ^ 

Line 80 puts the ball character on the screen at its current C 

position. Line 90 is a delay loop, leaving the ball on the screen ^ 

just long enough for your eye to see it. LinelOOnow erases the ^ 

bail by putting a space (code of 32) where it was on the screen. (^ 

Line 110 adds the direction factor to X. Line 120 tests to see if C 

the ball has reached one of the side walls, reversing the ^ 

direction and beeping if there is a bounce. Lines 130 and 140 do ^ 

the same for the top and bottom walls. ( 

Line 150 turns off the sound, if any, to complete the bounce C 

sound effect. Line 160 sends the program back to display and ^ 

move the ball again. 

c 
c 
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Play with this program a little. By ctianging the number in line 
80 from an 81 to another character code, you can change the 
ball to any other character. If you change either DX or DY to 0, 
the ball will bounce straight instead of diagonally. 

Now we can add a little more intelligence to this program. So 
far the only thing we check for is the X and Y values getting out 
of bounds for the screen. Add the following lines to the 
program shown above. (Just type these lines and they'll be 
added automatically) 

32 FOR L = 1TO10 

35 POKE 7680 + INT (RND (1) *506), 102 
37 NEXT 

155 IFPEEK(7680 + X + 22*Y) = 102THEN DX = -DX: DY = -DY: 
POKE 36876, 180: GOTO 110 

Lines 32 to 37 put 10 gray characters on the screen in random 
positions. Line 155 checks {"PEEKs") to see if the ball is about 
to bounce into a grey block, and reverses the ball's direction if 
so. 

See Appendices H and I for more information on animation. 
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Try typing this program: 

Type this program exactly as shown and see 
what happens! 



10 PRINT" 

20 FOR I = 1 TO 5 

30 POKE 36873+ 1,0 

40 NEXT I 

50 PRINT "WHICH VOICE (1-4)?" 

60 PRINT "IF DONE, ENTER 0" 

70 INPUT N 

80 IF N=0 THEN END 

90 PRINT "WHICH PITCH (128-254)?' 
100 INPUT P 
110 POKE 36878, 4 
120 POKE 36873 + N,P 
130 FOR J = 1 TO 2000: NEXT J 
140 GOTO 10 



To stop the program, press the HI key 




# 

C 

C 

c 
c 
c 
c 
c 
c 
c 
c 
c 
c 
c 
c 
c 
c 
c 
c 
c 
c 
c 
c 
c 
c 

G 

c 
c 
c 
c 
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MAKING MUSIC 

You may not realize it, but you and your ViC can mal<e music 
and sound effects! Tfiis chapter introduces you to tiie music 
and sounds that the VIC can mai<e. It will teach you how to 
control these sounds and play any kind of music from Bach — 
to Rock, So put your candelabra on your TV set, and get ready 
for a concert! 



First, let's find out how to play a note: 
Hold down the BMW key and press the 



key. 



[N] [E] [W] and press the ^HHmn^ key. 



and press 



O K E 



[HBBEianiKijm 



and press 

At this point, you should hear a tone coming from your TV 
speaker. If you don't, try adjusting the volume control on the TV 
in the normal way. Set it so that the tone is comfortably 
loud. ..like music on a TV show. 

You've just played middle C, one of 128 notes in VIC'S 
repertoire! To turn off the tone, type this; 



[p] [0] [K] i] ^^1 [U EEElEnE 

Next, let's find out how many notes the VIC can sing: 
Type NEW and press I 




6 NEXT I 

7 POKE 36875, 



Now, type this program 

1 POKE 36878, 15 

2 FOR I = 128 TO 255 

3 POKE 36875, I 

4 FOR D = 1 TO 100 ^n^m^H ^ 

5 NEXTD BBH ^^^^^^^^^H C' 

C 

c 
c 
c 
c 

# 

Take a tittle time to look at ttie VIC's screen, and see if all ot 

the lines on it look just like these. If any line looks wrong, just C 

type it over again. Make sure you include the line number. VIC -- 

will automatically substitute the new line for your previous ^ 

version. To get a listing of the lines in your program, type: ( 

LIST and press ^^^^^| C 

If all the lines are OK, type: " 

RUN and press ^^^^^| 

c 




and you will hear all 128 notes that the VIC can sing with this 
voice. (If you don't, recheck the lines as you typed them.) If you 
want to hear the notes again, type; 

RUN again, and press 

Now that you have heard the notes that your VIC can make, we 
want to explain a little bit about how it does all that. 

Inside the VIC, the Video Interface Chip (which gives the VIC its 
name} handles both sound and picture. It lets your VIC send 
sounds to the speaker of your TV set. The volume of sound can 
be adjusted by the volume control on the TV or from the VIC's 
keyboard. 
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THE FOUR VOICES OF VIC 

Your VIC has four voices. ..that is, it can "sing" four different 
notes to you at the same time! You might think of them as 
soprano, alto, tenor, and noise. Each of the voices has a 
particular "speaker controi number". By using this number, we 
can turn the speaker "on" and use it to create a musical note 
or sound effect. We use the word POKE to do this. 

The VIC'S four speaker numbers are: 

36874 {speaker 1 - music) 

36875 (speaker 2 - music) 

36876 (speaker 3 - music), and 

36877 (speaker 4 - noise). 

The volume control number is 36878. 






36874 . . . (alto) 36875 . . . (tenor) 36876 . . . (soprano) 





36877 . . . (noise) 36878 . . . (volume) 

speaker 1 

To play a note, type POKE and the speaker number, a comma, 
and a number representing the note you want to play. 

For example, type: 

POKE 36874, 128 and press 
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You've just sounded note #128 using speaker #36874, the first 
(lowest) voice. From now on, let's call ttiis speaker SI {short for 
speaker 1); the second, S2; the third, S3; and the fourth, S4. S2 
stngs higher notes than SI does, and S3 sings higher than S2. 
S4 sings with a buzz in its voice. ..this "voice" creates "white 
noise" used for sound effects. 

By the way, to turn off a voice, POKE into it, like this; 
POKE 36874, and press 



This might seem a little complicated if you're not a "computer 

musician" yet, so we've made it easier for you. You can save a ( 

lot of typing if you use the following short program to translate r 

the speaker numbers into shorter numbers. ^ 



Type this on your VIC exactly as shown: 
NEW 

51 = 36874 

52 = 36875 

53 = 36876 

54 = 36877 
V = 36878 



POKE V, 10 







This allows us to refer to the speaker numbers by the 

abbreviations SI, 82, S3. S4, and V (volume). Before proceeding, C 

check to make sure that each line has been entered correctly ' ^r 

Now you are ready to make sounds the easy wayl ^ 



( 
( 

c 

• 
• 
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This POKES 10 into the location that controls volume. The 
volume control can store any value betvi^een and 15. The 
higher the number, the louder the volume. 

POKE SI, 195 
POKE S2, 215 
POKE S3, 231 

Experiment a bit with this method of producing sounds. It's 
much easier, isn't it? When you want to stop the sound {to let 
your poor ears rest), POKE into the speakers you want to turn 
off, like this: 

POKES1,0 

P0KES2, 
POKE S3, 

Here is a chart of the values which can be POKEd into the 
speakers to get various notes: (Note: numbers below 128 produce 
"silence"): 

TABLE OF MUSICAL NOTES 



NOTE 


VALUE 


NOTE 


VALUE 


C 


135 


G 


215 


C# 


143 


G# 


217 


D 


147 


A 


219 


D# 


151 


A# 


221 


E 


159 


B 


223 


F 


163 


C 


225 


F# 


167 


C# 


227 


G 


175 


D 


228 


G# 


179 


D# 


229 


A 


183 


E 


231 


A# 


187 


F 


232 


B 


191 


F# 


233 


C 


195 


G 


235 


C# 


199 


G# 


236 


D 


201 


A 


237 


D# 


203 


Mt 


238 


E 


207 


B 


239 


F 


209 


C 


240 


F# 


212 


C# 


241 



By POKEing values into the first three voices (S1-S3}, you can 
even play tunes. ("White noise" isn't really appropriate to this 
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kind of thing. ..unless you dream of playing first-chair computer ( 
with Pink Floyd!) Unfortunately, this POKE process is very slow 

and tedious for a human. ..but it's child play for your VIC. So C 

let's put the POKEs in a program and let the computer do the m 

work! Anyone for "Flight of the Bumble Bee"? How about the ^ 

"Maple Leaf Rag"? M 



THE "WHITE NOfSE" GENERATOR 



c 

The fourth voice, S4, Is numbered 36877. We've called it "noise" ^ 

because it's actually a "white noise" generator, used primarily ( 
for special effects. Try making the buzz of an airplane: 

POKE V, 6 /-/~V~V IfV"^ 

POKE S4, 130 '^— V a very low tone ] ^ 

It's a four-engine prop job, right? Now, how about the wind A 

Whinnfnn hu thta u/inno r\f a crailnl^noO » 



whipping by the wings of a sailplane? 

POKE S4, 240 
Don't forget to turn on the volume with: 



POKE S4, 
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c 
c 
c 



POKE V,4 C 

c 
c 



or whatever volume setting you like best. Now let's turn off the ^ 

sound; 



c 



# 
c 
c 

c 



PLAYING SONGS 



Using the VIC speakers and table of musical note values, you 
can make up your own songs, or transcribe tunes from a 
songbook. The following songwriting program shows you how 
to do it: 



Type: 





NEW 

10 52 = 36875 

20 V =36878 

100 REM READ AND PLAY LOOP 
110 POKEV 



20 READ P 

130 IFP = -1 THEN 200 
■140 READ D 




POKE S2, P 

FOR N = 1 TO D 

POKES2,0 

F0RN = 1 TO 20: NEXT N 

GOTO 120 <r 



200 REM IF NOTE -1 THEN STOP 
210 POKE V,0 
220 END 



300 


DATA 225, 


1000, 


228, 


1000, 


231, 


1000 ( 


310 


DATA 232, 


1000, 


235, 


1000, 


237, 


1000 ^ 



320 DATA 239, 1000, 240, 1000 /-WaL 



pitch 
values' 

duration 
values 



330 DATA-1 <r 



"-4 the end \ 



In the first group of instructions then, we've set up the POKE 
locations for the speaker{s) we're using, in this case speaker 
2 and volume, and entered our abbreviations. The next group 
of Instructions begins at line 100. 
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Line 100 contains a REMark which explains what this section 
IS supposed to do. it's called a "loop" because the section 
Will read and play one note, then "loop" back to the 
beginning and do it again for another note. Line 110 turns up 
the volume. ^ 

Now we'll tell the VIC to find out what note to play: 



c 
• 
c 
c 
c 
c 



VICTIP: 

Programs don't have to start with line #1, or be 
numbered by 1. Most programs start at 10 and go up in 
increments of 10. This way you can go back and add 
extra lines in between if you want. For example, you 
could add a line 11,12, etc. between lines 10 and 20 
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Line 120 tells the VIC to look through the program and READ 
information — call it P — about what note to play. This 
information is contained in a "mystery statement" that we 
haven't written yet. Similarly, line 140 tells the VIC to READ 
information — call it D — about the duration of the note. 

Notice especially line 130. The function of this line is to stop 
tfie program when the last note has been read. Without some 
kind of "end of melody" marker, the program would try to read 
notes that haven't been written, and make an error Line 130 
says that when the VIC reads this marker, a value of -1 it 
should not try to play this note, but go to an ending module at 
line 200. We must remember to place -1 at the end of our 
"mystery statement." 

Now we'll have the VIC actually play the note, cut it off, and qo 
back for another: 



c 
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Line 150 simply POKEs the note we READ in line 120 into voice 
1, whiie iine 160 creates a deiay for the duration we READ in 
iine 130. Similarly, lines 170 and 180 turns off voice 1 for a short 
period. Line 190 sends the VIC back to line 120 to READ the 
next note. 

Now we have to write our ending section. Remember that our 
"end of melody" marker, -1, sends the program to line 200. 

Line 210 turns the voice off, and line 220 teils the VIC to stop 
performing the instructions in this program. 

Even though we've written the ending section, we're not quite 
done. We still have to v^frite our "mystery statements" to tell 
the program what notes to READ. These mystery statements 
are called DATA statements because they contain information, 
or data. DATA statements can be located anywliere in a 
program. Whenever the VIC encounters a READ instruction, it 
looks around for a DATA statement to READ. 

This module contains the DATA for a major scale. Line 300 
contains the first three notes. The first number is the POKE 
value tor the first note, 225 — low C. The second number sets 
its duration, 1000 — about 1 second. Line 310 contains the next 
three notes, and line 320 the last two. The values themselves 
are taken from the table of musical notes above. 

If the lines look correct, you're ready to RUN. You should hear a 
fairly accurate C major scale! If you have a "clinker" or two, try 
adjusting the values in your DATA statements, starting at line 
300. 

Once again: You can put DATA statements anywhere in your 
program. They will be READ one by one, starting with the 
lowest line number, and working tfirough each DATA statement 
from the beginning to the end. 
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Try substituting DATA statements to play other selections. For 
example, here's an old family favorite; «. 



300 
310 
320 
330 
340 
350 
360 
370 



DATA 225. 
DATA 228, 
DATA 228. 
DATA 235. 
DATA 231, 
DATA 232, 
DATA 225, 
DATA -1 



360, 225, 
120,231, 
120,231, 
720, 240, 
360, 225, 
120,231, 
480 



360, 225, 240 
360, 231, 240 
240, 232, 120 
360, 235. 360 
360, 235, 240 
240, 228, 120 




Or if you prefer classics: 



DATA217, 400. 213, 400, 223, 
DATA 227, 200, 234. 200, 230, 
DATA 227, 200, 234, 200, 230, 
DATA 223, 400, 227, 400, 217, 
DATA 213, 600, -1 



THE VIC AS PIANO 




Finally, here's a program that lets you play the VIC's keyboard 
like a piano: 

NEW 

10 REM STORE SOUND REGISTERS 
20 S2 = 36875 
30 V =36878 
40 POKES2, 

100 REM STORE B MAJOR SCALE 
110 F0RN = 1 TO 8 
120 READ A (N) 
130 NEXT N 



140 DATA 223, 227,230 
150 DATA 231, 234,236 
160 DATA 238, 239 

200 REM PLAY KEYBOARD 
210 POKE V, 3 

220 GET A$: IF A$ = " " THEN 220 
230 N = VAL(A$) 

240 IF N =0 OR N =9 THEN 300 




c 
c 

c 
c 
c 



) 



> l^^ ^SI^^®^; ^^ -^c M,-vTT Brief Silent interval 

260 FOR T = 1 TO 25: NEXT T ^^^^^^^ notes...Shhhhh 

270 P0KES2,A(N) Plays the tone 

280 GOTO 220 and returns to 



300 REM ENDING MODULE 

310 POKE S2, Turn off the sound 



look for another 

Turn off the sc 
before you go 



Now, when you type RUN (and press RETURN ), you can 

play tunes on your VIC. The keys in the top row with numbers 
on them control the various notes: 



1 


2 


3 


4 


5 


6 


7 


8 


DO 


RE 


Ml 


FA 


SOL 


LA 


Tl 


DO 



***************************************************** 

The VIC will keep playing the note you hit last until you hit 
another note. When you're done, press either or 9, and it will 
turn off. To start the VIC piano again, just reRUN the program. 

Try the following (sing along if you wish): 



1 


1 


5 


5 


6 


6 


5 


4 


4 


3 


3 


2 


2 


1 


5 


5 


4 


4 


3 


3 


2 


5 


5 


4 


4 


3 


3 


2 


1 


1 


5 


5 


6 


6 


5 


4 


4 


3 


3 


2 


2 


1 



OR: 



3 


3 


4 


5 


5 


4 


3 


1 


1 


2 


3 


3 


2 


2 


3 


3 


4 


5 


5 


4 


3 


1 


1 


2 


3 


2 


1 


1 



Take it away, Ludwig! 
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A FEW WORDS c 

ABOUT POKE 5 



c 



The command POKE lets you deal with your VIC on a ^ 

completely new level. POKE allows you to find a particular 

memory location and change what is stored there. Since this C 

command operates directly on the VIC'S memory, it is possible ^ 

to make mistakes by POKEing values into the wrong locations, ^^ 

or wrong values into the right locations! We want to repeat ^ 

what we told you way back in Chapter One: There is no way 

you can hurt the computer by typing on the l<eyboard... not even 

with POKE. But you can cause the VIC to just go away 

someplace and sulk, cutting you off from any contact. For 

example, if you're ready to end this session anyway, try typing: 

POKE 788, 

You may find that the only way you can regain communication 
with a computer that has been "insulted" in this way is to type 
RUN/STOP and RESTORE. If the "crash" is serious, you may 
have to turn it off and turn it on again. This doesn't harm the 
computer, but it does mean that whatever program you were 
working on will be lost. Even if this should happen to you, a 
little typing time is normally the extent of the loss. But it does 
suggest that you should be careful of what you POKE. It also 
underlines the value of accessories like disk drives and data 
cassettes, which can store programs, as well as printers, which 
can at least give you a program listing that would help you 
reconstruct a lost program. 

We recommend that you make a brief study of POKE in 
Appendix C before you begin to POKE around indiscriminately 
in your VIC. At least try the examples we give you in this book. 
Be careful typing those long numbers, and double check your 
work before you run your programs. A computer that has been 
POKEd in the wrong place may well reason that turnabout is 
fair play, and simply "turn you off." 

In this chapter, you've learned how to make Bach and 
Beethoven sit up and take notice. You know how to drive your 
friends crazy and make them long for the good old days when 
your VIC was a quiet, miid-mannered little creature that kept 
pretty much to itself. So what if the VIC isn't quite as talented 
as Beverly Sills or a Steinway concert grand? You and VIC can 
still make beautiful music together! Maestro, please... 
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Try typing this program: 

Type this program exactly as shown and see 
what happens! 



C 

c 

c 
c 
c 
c 



10 INPUT"DEGREES FAHRENHEIT";F 

20 PRINT F"DEGREES F." 

30 PRlNT'lS"(F-32)*5/9"DEGREES G." 

40 PRINT - 

50 GOTO 10 



To Stop the program, press the 



and hit 



RESTORE 




C 



Typing the 
word PRIN'i 
by itself ■( 
on a line J 

adds a blank ( \ 
line when 
the program 
is run. Try 
it with and 
without this 
line 
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(. 

c 
c 

# 

c 

c 

c 

c 

c 

c 

c 

c 

c 

( 



Good morning VIC. Your mission (and we know you are going 
to accept it) Is to perform miracles whenever v;e touch just a 
few keys! 

Yes, your VIC is ready, able and willing to respond to your 
touch like no other computer ever made. So let's buckle down 
to some non-stop fun! 



Hold down the BiiUm key and press the Ugfil key. 
Type the following keys: 

[n] [U |W] and press the 
key. 




and the ^^^^B key 



[2]' SEJEQEHH 

and the ^^^^^H key. 



QEH 



IE 1g] [O] [t] [g] m and the 



key. 



Now press [RJ [UJ [H and 
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And the VIC responds: 



c 
c 
c 
c 



1 INPUT "WHAT'S YOUR NAME";A$ 

2 PRINT" HI, "A$ 



3 GOTO 2 



WHAPS YOUR NAME? 




At which point you type in the customary response or if your 
name happens to be VIC you can type: 

[v] [D [C] and 



And whoopee! Your nanne splashed all over the screen! To 
slow down the show just press the R^fl key. When you 



are ready to leave stardom behind, press the RJJJ key. 

To enter another name just type RUN and you will see the 
same prompt again. The prompt in this case is: 
WHAT'S YOUR NAME? 

Prompts are questions directed to you in an effort to get in- 
formation into the VIC. The VIC has a limited number of ways 
to get information from the human world. Perhaps the most 
useful method for the computer to collect information from 
our keyboard is the INPUT statement. Let's go through the 
steps of our program. Here's what we told VIC to do: 

First, display the message "WHAT'S YOUR NAME'^ on the 
screen and then wait for you to put in (or INPUT) characters 
from the keyboard. Take the response and name it "AS". In 
our example "VIC" becomes A$. This is a kind of shorthand 
for the computer. 

Second, print the word "HI" followed by whatever was typed 
at the keyboard. In our example we print HI VIC. 



c 
c 
# 
c 
c 
c 
c 



c 



Third, go back to line number 2. 



The second and third steps combine to make the VIC con- 
tinuously print the message "Hi" all over the screen. If we 
changed line 3 to read; 

3 GOTO 1 

then the message HI VIC would print on the screen only once 
and the message prompt "WHAT'S YOUR NAME" would ap- 
pear again. This alteration makes the VIC appear to have 
amnesia! 

Whenever we use the INPUT statement, our program holds 
everything while awaiting a response from you. It is important 

to note that VIC will wait forever or until the 
is pressed, whichever comes first. 



RETURN key 



In our program we created a friendly prompt. Unless we tell 
the VIC what we want our input message to say, we will just 
get a simple "?" which does not tell us much. So we will try to 
build prompts which suggest what type of input is 
required. 



Press 



and 



at the same time. 



NEW 



READY 



1 INPUT A$ 



Type NEW and 

1 INPUT A$ 

When we type RUN the 
VIC screen looks like: 

The question mark alone 
raises more questions than it 
answers! So let's try this: 

1 PRINT "MAY I HAVE YOUR NAME":INPUT A$ 

2 PRINT "WHAT IS YOUR FAVORITE FOOD":INPUT B$ 

3 PRINT 

4 PRINT "THANK YOU,"A$" FOR YO UR POLIT E ANS WER" 

5 PRINT "WE WILL GIVE YOU SOME ^^^ "B$" 

AS A GESTU RE OF OUR APPRECIATION" 

After typing RUN and |^^^^^ you will see that treating 
messages with respect can result in a treat for your efforts! 
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INTRODUCING VARIABLES 

Many of the programs used in this book use variables to 
simplify or strengthen the program. 

Variables are very useful because they can be used to repre- 
sent numbers, formulas, graphic symbols, words, phrases — 
even w^hole sentences. Examples of variable names are: X, A8, 
S2, X$, AB$, S2$. The easiest way to explain the power of 
variables is to tell you that these simple variables can each be 
used to represent up to 255 characters! 

There are two kinds of variables: numeric variables and string 
variables. Numeric variables are used to store numbers (ap- 
tually, numeric values). String variables can be used to store 
all types of characters (numbers, letters, graphics, cursor con- 
trols, color controls, etc.). 




BOX 



c 
c 



c 
c 
c 
c 
c 
c 



BOX AS 



t 

c 
c 
c 



Variables are like storage cabinets inside the computer. To tell 
the VIC that cabinet is for numbers or values, we must use a 
special name. Numeric variable names may be one or two 
characters long and may be one letter, two letters, or a letter 
and a number. Here are some examples of numeric variable 
names: 



AB 



S2 



C2 



AA 



ZX 



String variable names may be one, two or three characters 
long (including the $ sign), must always begin with a letter 
from A to Z and have a dollar ($) sign at the end. Here are 
some string variable examples: 



X$ 



AB$ 



82$ 



C2$ 



AA$ ZX$ 
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Here's a short program that shows one way to use variables: 

10A$ = "VIC20" 

20 PRINT"HELLO,"A$ 

RUN 

The VIC will display HELLO, VIC 20. Why? Because in Line 10 
we told the VIC that the variable A$ is the same as "VIC 20". 
Now try this: 

10A = 2 

20B = 3 

30G-4 

40PRINTA*B*C 

In this example, A*B*C is the same as 2*3*4 because we 
"stored" the numbers 2, 3, and 4 in the variables A, B, and C. 

Here's a final example that uses two kinds of variables with 
INPUT statements. The INPUT statement allows the person 
running the program to define what the variable will stand for 
like this: 

10PRINT"WHAT WORD DO YOU WANT X$ TO STAND FOR": 
INPUT X$ 

20PRINT"WHAT NUMBER DO YOU WANT X TO STAND FOR": 
INPUT X 

30PR!Nr'NOW XS STANDS FOR" X$ 

40PRINT"AND X STANDS FOR" X 

RUN 
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CHOOSE A NOTE 

For this INPUT example we will tinker a little with VIC sound. 

Type: 

NEW 

10 INPUT"HOW HIGH A NOTE";} 

20 IF H=OTHEN 90 

30 INPUT"HOW LONG A NOTE";L 

40 POKE 36878,15 

50 POKE 36875,H 

60 FORT-1 TO LNEXT 

70 POKE 36878,0 

80 GOTO 10 




90 END 

After you press 



the screen should look like this: 



HOW HIGH A NOTE? 225 



HOW LONG A NOTE? 1000 



Type a number 
from 128 to 254 



c 
c 
c 

c 
• 
c 
c 
c 
c 
c 
c 
c 
c 



c 
c 

c 



Press the i^mmi^^ Key and listen to the pitch and dura- 
tion of the note. After each note you can create another and 
gain an appreciation for how these "mysterious" POKES 
translate into sound. 
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The first two lines of "make a note" (10 and 20) give us the 
flexibility necessary to vary the pitch in line 50 and 60 respec- 
tively. Line 30 is our "door" out when we are finished ex- 
perimenting (just type (zero) in response to HOW HIGH A 
NOTE?). Line 70 turns off the voice which was activated 
earlier in line 40. 

If you want all the noteworthy details on making music with 
your VIC, turn to chapter five. 



THE GET STATEMENT 

Now that you have mastered the INPUT statement, we will 
move on to a fancier way of getting information from the 
keyboard. 

The GET statement is used to get characters from the 
keyboard one character at a time. In fact, the person RUNning 
the program need not even hit the RETURN key! Here's how 
the statement looks! 

lOGETAS 

How do we make a program stop and wait for something to be 
typed? We put the program in a loop with an IF. ..THEN state- 
ment checking for an answer. 

lOGETAS 

20IFA$ = ""THEN 10 



What is the use of this? For a very simple application, the lit- 
tle 2 line program above will allow your program to pause until 
the operator hits a key on the keyboard. This is helpful in 
freezing a display on the screen until the person has read it 
and wants to go on. 

Here is an expanded application for the GET statement: 

lOGETAS 

20IFA$ = ""THEN 10 

30 IF A$ = "A" THEN PRINT "CHICKEN SOUP" 

40 IF A$ = "B"THEN PRINT "SPAGHETTI" 




50 IF A$ = "C" THEN PRINT "STEAK AND EGGS" 

60 GOTO 10 

RUN 

When this program has been typed in and RUN, it will wait for 
the operator to hit any key. If the key was the letter A, the 
words, CHICKEN SOUP appear on the screen. The letter B 
makes the word SPAGHETTI appear, and the word C makes 
the words STEAK AND EGGS show up. You now have the VIC 
typing whole words with only 1 keystroke! 

Now you will get the longest program so far, a practical exam- 
ple of the GET and PRINT statements used to give you a com- 
puterized recipe file. Don't be alarmed by the size of this pro- 
gram. It uses mostly simple PRINT statements but the lesson 
here is how the A$ variable is used to stand for several whole 
phrases, and how the GET command 



10 PRINT '■ KilH [JUgg PLEASE PICK A CHOICE" 
20 PRINT "FROrvl THE MENU:" 

30 PRINT 

40 PRINT "A. ..CHICKEN SOUP" 

50 PRINT "B... SPAGHETTI" 

60 PRINT X... STEAK & EGGS" 

200 GET A$:IFA$ = ""THEN 200 <- 

210IF A$-"A"THEN 500 

220IF A$ = "B"THEN 700 

230IFA$ = "C"THEN900 

490 GOTO 200 

500 PRINT " ^^^B ^H MIKE'S CHICKEN SOUP" 

510 PRINT 

520 PRINT "TAKE 1 CHICKEN. KILL- 



SO 




c 



( 

c 
c 

c 
( 

c 

{ 
( 

c 
c 
c 
( 
( 
( 

c 

c 

( 

c 



c 

c 

c 

• 

c 

c 



530 PRINT "AND PLUCK. REMOVE" 
540 PRINT "GIBLETS. BOIL 4 QTS" 
550 PRINT "WATER IN A LARGE POT." 
560 PRINT "ADD CHICKEN. BOIL" 
570 PRINT "2 HOURS, OR UNTIL" 
580 PRINT "HOUSE SMELLS GOOD." 
590 PRINT < ■ 



600 PRINT "HIT ANY KEY TO GO ON" 
610 GET A$;IF AS-"" THEN 610 
620 GOTO 10 




ffl MA'S SPAGHETTI" 



700 PRINT" 
710 PRINT 

720 PRINT "BROWN 1 LB. GROUND" 

730 PRINT "BEEF, WITH 1 ONION" 

740 PRINT "AND 1 GREEN PEPPER." 

750 PRINT "ADD 1 LG. CAN TOMATO" 

760 PRINT "PUREE, 6 OZ. CAN TOM." 

770 PRINT "PASTE, 6 OZ. WATER," 

780 PRINT "3 CLOVES GARLIC, SALT ' 

790 PRINT "& PEPPER, RED PEPPER," 

800 PRINT "OREGANO. SIMMER 1 MR" 

810 PRINT "& SERVE WITH COOKED" 

820 PRINT "NOODLES." 

830 GOTO 590 
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900 PRINT " ^nn^' ]jji^ STEAK AND EGGS" 
910 PRINT 

920 PRINT "TAKE 1 COOKED STEAK" 

930 PRINT "AND COOKED EGGS." 

940 PRINT "SERVE TOGETHER WITH" ' ■*• 

950 PRINT "BEVERAGE." 

960 GOTO 590 



If you typed the program 
correctly and typed RUN. 
the screen should come up 
with the following display: 



PLEASE PICK A CHOICE 
FROM THE MENU: 

A...CHICKENSOUP 
B... SPAGHETTI 
C...STEAK&EGGS 



Now the VIC is waiting for you to hit a key. If you type 
anything other than A. B, or C, nothing happens at all {Line 
200 does this). If you hit the A, you get the recipe for Mike's 
Chicken Soup. Pretty terrible, huh? You can tell Mike is a 
bachelor. 

This can be lengthened and modified very easily for your own 
use. To add items to the menu, just add a PRINT statement 
after line 60, add a new IF statement after line 230, and add 
the recipe wherever there is room at the end. The last line of 
your recipe should be the line GOTO 590, which tells the per- 
son RUNning the program to hit a key to continue. This will 
keep the recipe on the screen until they are through with it. 

You can use the program we just described for more than 
recipes, of course. How about a name and address file? In- 
stead of a "menu" use last names with initials. Instead of 
recipes, use the person's name, address and phone number. 
Can you think of other uses for GET and INPUT based pro- 
grams? This is the true power of computing — being able to 
tailor what the computer does to your own needs. 



!:■'••-*.■ 



Try typing this program: 

Type this program exactly as shown and see 
what happens! 



10 PRINT 



20 PRINT CHR$(205.5+ RND(1)); 
30 GOTO 20 



To stop the program, press the 
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YOUR FIRST BASIC 
PROGRAMS AND HOW 
THEY WORK 

Until now, you've been patient and typed in several programs 
without understanding how they work. This chapter will explain 
what those tricky little programs were all about, and get you 
further along the road to programming your VIC. 

PROGRAM 1: Your Name In Lights 
(Chapter 2) 



10 PRINT 


'^ 


H" 


20 FORT: 


= 1 TO 300 


NEXT 


30 PRINT 


'your name" 


40 FOR T = 


= 1 TO 300 


NEXT 


50 GOTO 10 






There doesn't seem to be much to this little program, but once 
yoii understand what's going on here, you have the key to doing 
animation. Line 10 is the PRINT command, with the character 
meaning "clear the screen" inside the quote marks. If you tried 
to type this without the quotes, your program line disappeared 
from the screen before you could finish typing it. The VIC only 
recognizes a new line when you hit the RETURN key with the 
cursor on that line. 
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VIC TIP: QUOTES 

Let's talk a little more about what happens when you hit the quote key. 
The first time you tiit the quote, something tunny happens. If you hit 
HOME, CLR, cursor up, down, (eft, or right, you get a reversed graphic 
character. This also happens on ttie VIC when any of the color control 
keys are pressed. You see, quotation marks are used in computer 
programs and the VIC recognizes quote marks as a Programming 
Command. Therefore, when you hit a color or cursor control key after a 
quote mark, the VIC displays a special code to designate that 

operation. For example when you type " and 

you get a reverse heart on the screen. If you see 

this in a program you know it means clear screen. Other symbols 
stand for other operations. Once you have hit the quote key for the 
second time, any cursor controls and color keys will work normally. 

The INSERT key causes a similar effect. When this key is hit, every 
space created on the line m\\ act as if it was in quote mode. All cursor 
control characters will appear as if they were inside quote marks. In 
addition, the DELETE key will produce a special reversed graphic 
character in these spaces, which will have the effect of deleting 
characters when the program is listed, and printing DELETES on the 
screen v/hen PRtNTed. 



Line 20 of the program is cailed a time delay loop. This is 
actuaiiy two BASIC statements on one line, separated from 
each other by the colon {:). All that happens here is that the VIC 
will count from 1 to 300, without doing anything else. This 
serves to slow down the program a little. (Try deleting the lines 
20 and 40 and RUNning the program. It blinks too fast!) 

In tine 30, you typed your name inside the quotes (At least we 
hope you did.) This caused your name to be printed on the 
screen. There was nothing else on the screen because line 10 
already cleared it off. 

Line 40 is another delay, to give your name time to be on the 
screen long enough to see. 

Line 50 causes the program "go to" line 10 as the next line to 
be executed and briefly clears the screen. 

After your name is displayed on the TV screen, there is a delay 
of a second, after which the screen is erased. After another 
second, the name is displayed again in the same position. 
Again, it is erased, and so on. Because the letters appear in the 
same position on the screen, your eye believes that they are 
blinking on and off. 
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Experiment with this program. You can make the defays 
between displaying and erasing your name tonger or shorter by 
changing the number 300 In lines 20 and 40. 

PROGRAM 2: A Lot of Heart 
(Chapter 3) 



10 FOR H = 


= 1 TO 505 




20 PRINT ' 


V "; 




30 NEXT 






40FORC = 


= 8 TO 255 STEP 17 


50 POKE 36879, C 




60 FOR T = 


= 1 TO 500: 


NEXT 


70 NEXT 






80 GOTO 40 





This program provides you with a colorful display of hearts. It 
introduces the use of punctuation marks in PRINT statements 
and the use of POKE to change the screen and border colors. 

Line 10 sets up a loop that counts from 1 to 505. We want 505 
hearts to appear on the screen, because there are 506 spaces 
on the screen. If we PRINTed the 506th character, the screen 
would be forced to roll up one line (scrolling), and there would 
be less hearts on the screen than before. 

Line 20 PRINTs the heart character on the screen. The semi- 
colon (;) after the last quote has an important effect. You see, 
after a normal PRINT statement, the VIC will automatically 
perform 2 operations — move the cursor back to the beginning 
of the line (called a carriage return), and move the cursor down 
to the next line (called a linefeed}. The punctuation mark at the 
end of the line will cancel the return and linefeed, so that the 
next thing PRINTed will appear immediately to the right of the 
last thing PRINTed. 

Line 30 just completes the delay loop. As long as the value of H 
is 505 or less, the program will print hearts on the screen. When 
the 505th is printed, the program continues with the line after 
this one (line 40). 
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Line 40 establishes a new ioop and sets up line 50, which 

changes the screen and border colors. C is defined as a series 

of numbers from 8 to 255, which increase in increments of 17. 

Every time line 70 (NEXT) is hit, 17 is added to the previous 

value of C and the sum is used for the new value. This causes a 

cycle of colors to be selected including black border with black 

screen, white border with white screen, etc., for all 8 border 

colors. Then the numbers in C go beyond the values for those • 

colors and pick 7 different colors for the screen. (See Appendix /-, 

I for a list of color numbers) ^ 

Line 50 is the statement that actually changes the color.- The ^ 

value contained in variable C is stored in memory location * 

36879. This is actually a location on the VIC chip itself, not in * 

your normal area of memory. ^ 



Line 60 is a delay loop. If this line is removed, the colors will ^ 

change fast enough to give you a headache. ^ 

Line 70 completes the loop started in line 40. Notice that the 
line could have read 70 NEXT C, but doesn't have to be that 
way. 



c 
c 



Line 80 sends the program back to cycle through the colors ( 
again. It will run forever, unless you press the STOP key, or turn 

off the VIC. Typing POKE 36879, 27 after you hit STOP will C 

restore the normal colors of the screen. a 
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PROGRAM 3: Exercising VIC Person 
(Chapter 4) 



10 


PRINT " 


H'' 


20 


PRINT ' 


'KDZ" 


3D 


PRINT' 


1 1 « ■ ■ r 1 

■ ■ 

i ■ • f )l 

■ ■ 
■ ■ < 


40 


PRINT' 


•Z \" 


50 


FORT = 


= 1 TO 300: NEXT 


60 


PRINT 


ipri ,, 


70 


PRINT 


■ O " 


80 


PRINT 


■ 7 ^ \ ■ 


90 


PRINT 


II 


100 


FORT: 


= 1 TO 300: NEXT 


110 


GOTO 10 



This program is similar to the first program we did, called Your 
Name In Lights. However, instead of drawing an image and 
then blanking it out, like the first program did, this one draws a 
complete picture, pauses, and replaces the image with another 
complete picture. The head and body of the VIC person stays in 
the same position while the arms and legs change places. This 
gives the illusion of movement from one position to the next. 

Lines 10 and 60 bring the cursor to the upper-left corner of the 
screen, which is known as the home position. This forces the 
image of the VIC person to be displayed in the same screen 
position each time. 

Lines 20, 30, and 40 will "draw" each line of the VIC person's 
first image. 

Lines 50 and 100 are delay loops, just to give the picture 
enough time on the screen. 

Lines 70, 80, and 90 draw the second image on the screen. This 
takes place so fast that you can't see the transition — your eye 
sees the change from one to the other as instantaneous. 
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PROGRAM 4: 
(Chapter 5) 



Choose A Note 




NEW 
10 PRINT' 

FOR I = 1 TO 5 
POKE 36873+ 1,0 
NEXT I 




PRINT "WHICH VOICE (1-4)?' 
PRINT "IF DONE, ENTER 0" 
INPUT N 



IFN=:0THEN END 

PRINT "WHICH PITCH (128-254)?" 

INPUT P <- 

POKE 36878, 4 — 

POKE 36873 -I- N,P 

FOR J = 1 TO 2000: NEXT N 

GOTO 10 



When you've checked that all the lines are correct, try running 
this program (type RUN and press RETURN). It will let you 
select a voice and a pitch, and play the tone you've chosen for 
about two seconds. The sound shuts off, and the program asks 
you for another voice and pitch. This program is a musical 
experimenter's delight, so be sure to give it a try. When you 
wish to stop the program, enter as a voice selection. You may 
suspect there's a problem when you select pitch 254 in voice 3 
and hear nothing. Actually, it's not an error — this note is just 
too high for human ears, (you might test it out on your dog 
though!) 



c 

# 
c 
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PROGRAM 5: Temperature Conversion 
(Chapter 6) 



10 INPUT "DEGREES FAHRENHEIT"; F 


20 PRINT F " 


DEGREES F." 


30 PRINT "IS 


' (F-32)*5/9 "DEGREES C." 


40 PRINT 




50 GOTO 10 





Thiis introduces you to ttie INPUT statement, which allows your 
program to stop what it is doing and request necessary 
information from the operator (the person who is RUNning the 
program). 

Line 10 causes the message DEGREES FAHRENHEIT? to 
appear on the screen. The words inside the quotes of an INPUT 
statement work just like the PRINT statement. However, the 
last word will always be followed by the question mark 
character, and the program will wail at this point for more 
information. 

Line 20 prints the value of F, which is what was just typed in 
(inputted). Line 30 prints the result of the conversion 
calculation. In line 40, the word PRINT alone on a line causes a 
blank line to appear on the screen. 

Finally, line 50 makes the program go back to the beginning 
and request more information to start again. The original 
question will be asked again, and you can have more 
temperatures converted. If you are finished, hold down the 
STOP key and hit the RESTORE key. There is no other way to 
tell this program you are through. 
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PROGRAM 6: Random Maze 
(Chapter 7) 



10 PRINT" 


Bl 




It 


20 PRINT CHR$(205.5 


+ RN 


D{1)}; 


30 GOTO 20 









This is a neat little program that prints pseudo-mazes all over 
the screen. As you may expect, line 20 is the key here. 

The CHR$ function will give you a character based on a code 
number from to 255. Every character that the VIC can put on 
the screen Is encoded this vi/ay (see AppendixH). To find out 
the code for any character, just type PRINT ASC("X") where X is 




the character you're checking. Then type PRINT CHR${X) where 
X is the number the VIC gave you. See how it works? 

Now try typing PRINT CHR$(205); CHR$(206). This should print 
the two right side graphic characters on the M and N keys. 
These are the two characters that the program is using for the 
"mazes". 

By adding the formula 205.5 + RND(1), the VIC will pick a 
random number between 205.5 and 206.5. There is a fifty-fifty 
chance of the number being above or below 206. When the 
CHR$ function works, it will ignore any fractional values. 
Therefore, half the time the character with code 205 is 
PRINTed, and the other half character code 206 PRiNTs. 

If you'd like to experiment with this program, try changing the 
205.5 by adding or subtracting a couple of tenths from it. This 
would give either character a greater chance of being PRINTed. 



c 
c 



c 
c 
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MORE ABOUT RANDOM 
NUMBERS 

The random number function is one of thie most useful and 
enjoyable aspects of BASIC, allowing you to program all sorts 
of games of cfiance. 

Tfie line X = RND(1} will cause tfie VIC to select a random 
number between and 1, not inclusive, to be placed into X. Tfiis 
results in a range of possible values for X: 

0<X<1 

When you work witfi random numbers, it is best to keep in mind 
tfiat you wiSi generate a range of numbers, to see hiow 
calculations effect ttie vi/fiole range. For example, if you wanted 
to get a set of possible values between and 3, you could just 
multiply X by ttiree. The new range is: 

0<X<3 

If you needed to pick a number from 10 to 20, how would you 
perform a calculation to change the range? First, you would 
add 10 to the number picked, to change the range to 

10<X<11 

By multiplying the random number by 10 before adding 10, the 
range becomes: 

10<X<20 

So the formula for a random number between 10 and 20 is: 

X = RND(1)*10 + 10 

So far, we have learned how to change the range of possible 
results for the random number. However, the result of the 
function will contain messy decimal places, which are not 
desirable for things like rolling dice or picking a number from 1 
to 10. The function used to clean this up is the INT function. 
This will chop off alt decimal places from the number. The 
formula for a random number from 10 to 20, with the INT 
function added, becomes: X = INT(RND(1)*10 + 10} 
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The range of possible results is now: 
10<-X<-19 



( ' 

c 
c 
c 



( 



But wait! The upper limit of the range has dropped from 20 to C 

19 in this case. Why? Because before the range was always 

less-than 20. The INT function will strip off any decimal places 

from a number greater than 19 and less than 20 to result in a ( 

19. On the other end of the range, any results between 10 and 

eleven are truncated down to an even 10. If we still needed to 1 

get a range of numbers from 10 to 20, the formula should 

become: 

X = INT{RND(1)*11+10) 

The random number is multiplied to expand the range, and 
added to move the range. 

The general formula for a set of random numbers in a certain 
range is: 

X-INT(RND(1)*a) + b 

Where a represents the number of possible results and b is the 
lowest number in the range. 



c 
c 

c 
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APPENDIX A: VIC ACCESSORIES — 
A QUICK INTRODUCTION* 

This is a beginner's user manual, so we are not going to spend a lot 
of time and space teiling you about ttie various periptierais that plug 
into the slots on the back of your VIC, 

Each of the VIC peripherals will have its own instruction manual, 
which will tell you how to connect it to the VfC and how to use it to do 
interesting things. 

Commodore has designed the VIC to grow with your needs and has 
an overall plan of how the various peripherals will fit together in and 
on the VIC, Here is the map of that plan: 



THE COMMODORE VIC 20 
PERSONAL COMPUTER SYSTEM* 



( PRINTES jj 



UK. ^K- -^K 

ME.WCRr 
t3(PAN[^£=?S 



PLUG-IN 



c 

c 

c 

c 

c 

c 

o 

o 

c 

c 

c 

c 

< 



INTERFACE J 
CAWtPuKiEl/ 



5INGUt 
DISK 
DRIVE 



RF 
MOD 

CABLE 



£)(f'rtHD£H 



P«0G»AM5 



mr 



MAI-iTFB CC'if 



USEftfORT CASSETTE 
POAT 



SERIAL 
BUS 



v;0EO 
oyTPuT 



EKPAhrSlON 
PORT 



VIC 20 COMPUTER 



1 JOYSTICK 

on 

i VGHT PEN 
1 PADDLES 



SPECIAL PLUG-IN PROGRAMS 

Super Expander Cartridge — 3K Added Memory (converts VIC to 8K) 

High Resolution Graphics & Plotting 

Commands 
Pre-assigned Function Keys 

Programming Aid Cartridge — Programmer's "tool kit" 

Machine Language Monitor 
Pre-assigned function keys 

(prog commands) 
User-assignable function keys 

"Note: Peripherals described in this section scheduled for sale during 
late 1981, 
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TAPE CASSETTE RECORDER 

The first peripheral you wiil probably get will be the Commodore tape 
recorder. The tape recorder can store several thousand characters 
(letters and numbers) on an ordinary cassette tape. You can store 
quite a few long programs on tape and load them back fairly quickly, 
without having to type them in every time. (See Appendix B - Working 
With Tape Cassettes) 

The VIC Tape Cassette plugs into the Cassette Interface slot on the 
back of the VIC with its own special plug — it does not need any 
special interface. Commodore provides a variety of computer 
programs on tape for use with the cassette recorder. 



MASTER CONTROL PANEL 

You can plug a Master Control Panel in to the Expansion Port on the 
back of the VIC. This controller lets you use more than one cartridge 
at one time. It has six slots and accepts program cartridges, memory 
expanders and includes an IEEE-488 interface which lets you use 
Commodore PET/CBM peripherals and other IEEE devices. 



VIC SINGLE FLOPPY DISK DRIVE 

The VIC Single Floppy Disk Drive can store up to 170,000 characters 
(letters and numbers) and move a very long program in or out of the 
VIC's memory in a fraction of a second. No long waiting for a tape 
drive to find, read and load a program. This device connects to the 
VIC'S serial port. 



IEEE-488 INTERFACE CARTRIDGE 

IEEE-488 is a universal scientific standard that lets you use 
Commodore PET/CBM peripherals such as disk drives and printers, 
as well as scientific instruments and tools. 



SERIAL PRINTER 

The VIC has a Serial Interface for peripherals which use serial 
connections to communicate with the computer. With Commodore's 
special dot matrix printer that uses this serial connection you can 
print your program listings and results on paper. 
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GAME PORT ( 

The VIC Game Port allows you to tiook up joysticks, light pens, and ^ 

paddles, so that you can easily play exciting arcade type games 

without having to use the keyboard. f 

c 

TELECOMMUNICATIONS C 

You may have heard about programs that let your personal computer ( 
talk to other computers and get information about the Stock Market, 

Business, News and other things — the VIC has this ability already C 

built in. ^ 

The VIC'S User Port includes an RS232 interface which lets you obtain ^ 

or exchange information over the telephone using an inexpensive 
telecommunications modem. A 



SOFTWARE • 

In addition to all of this hardware, the VIC has a lot of interesting f 

software. , 

{ 

Some software programs are stored in hardware cartridges which 

plug in to the back of the VIC and are ready to run as soon as the v 

power is turned on. Some are on tape, some are on disk, and many , 

are included in the VIC Learning Series Book and cartridge sets which 

let you teach yourself computing and other subjects at home. ^ 

This has been just a short overview of accessories available to you. f 

KEEP IN TOUCH WITH YOUR 4 

COMMODORE DEALER TO FIND OUT ^ 
ABOUT THE NEWEST DEVELOPMENTS! 
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"APPENDIX B" 

USING THE CASSETTE RECORDER 

The cassette recorder acts as the VIC's "memory". Without this 
device, the VIC will forget any program you typed in as soon as the 
power goes off (or someone uses the NEW command). You can also 
use the recorder for programs you purchase. Commands used with 
programs on tape are SAVE, LOAD, and VERIFY. 

The VIC can also "remember" the values of variables and other 
items of data, collected in a group called a file. The amount of data 
stored in a file can be very large compared to the amount of RAM in 
the VIC, because the VIC can operate on a small piece of the file at 
a time. Statements used with data files are OPEN, CLOSE, PRINT#, 
INPUTS, and GET#. The system variable ST (status), is used to 
check for tape markers. 

PROGRAM STORAGE 

Let's say you have just finished creating a new program on the VIC. 
You will want to use the program again at some other time, so now 
you must store it on the tape. Type the word SAVE. If you want the 
program to have a name, type a quote mark (") and the program 
name. The name can contain graphics and cursor controls, and can 
be up to sixteen characters long. Then just hit the RETURN key, 
whether you gave it a name or not. 

If your recorder is plugged into the back of the VIC, and none of its 
buttons are pressed down, the following message will appear on the 
screen: 

PRESS PLAY AND RECORD ON TAPE 

All you have to do now is put a blank cassette tape (any decent 
audio tape will do) in the recorder. Hold down the RECORD key and 
hit PLAY on the recorder. The tape should start moving, and the 
following message will appear on the screen: 
OK 

SAVING name 

What the VIC is doing now is recording, with a very fast series of 
high and low sounds, your program in RAM onto the tape. The 
program is not being disturbed at all, it is just being copied. The 
VIC actually records the program twice, just in case your blank tape 
isn't perfect. When the program is all on the tape, the ViC stops the 
recorder (all by itself!) and gives the READY message. 

Now you may wish to check the tape to make sure that the SAVEd 
program is correct. After all, you are risking much of your valuable 
time to an uncertain piece of thin magnetic tape. It is better to be 
safe and check the program. 
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The command to check the tape is called VERIFY. First, rewind the { V 
tape back to the beginning. Now type the word VERIFY. If your 

program had a name, you may type a quote mark and the name. If C 

you want to VERIFY the first program on the tape, you can just ^, 

leave off the program name. Next just hit the RETURN key. * 

Now, if none of the keys on the recorder are pressed, the VIC will ^ 



tell you this: 



( 



PRESS PLAY ON TAPE Q 

Be very sure that the RECORD button is NOT down when you do # 

this. That would result in erasing any program or data that may have 

been on the tape. C 

When you've pressed PL/^Y, this message appears: " 

SEARCHING FOR name • 

From this point on, the VIC will search for the program you have 

specified on the tape. If it finds any programs or data files, it will 9 

report the fact with the message: 

FOUND name ^ 

If the name of the program matches, or at least matches as many ^ 

letters as you gave (which is why giving no name checks the first 
program), the next message is; 

VERIFYING 

When the program is completely read on the tape, the VIC gives you 
the verdict. You may see the message: 

OK 

READY. 

This means that the program on the tape was identical with the 
program you have in RAM currently. 

If the programs did not match, you'll see the message: 

7VERIFY ERROR 

READY. 

One of the extra uses o{ the VERIFY command is to position the 
tape right after the last program, so you can add a new program to 
the tape. Just VERIFY using the name of the last program on the 
tape. You will end up with a VERIFY ERROR, but the tape will be 
right where you want it. Tricky, right? 
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Now let's say that you've come bacit to ttie VIC and you want to use 
ttiat program you stored away. Ttie command for this is LOAD. Type 
the word LOAD, and you can follow it with a program name 
(enclosed in quotes) if you like. The VIC says: 

PRESS PLAY ON TAPE 

You must press only the PLAY key on the recorder. The V!C will 
now say: 

SEARCHING FOR name 

Just as in VERIFY, the VIC lets you know of any programs or files 
encountered until the matching name. Then this message appears: 

FOUND name 

LOADING 

Wfien the program is loaded, the VIC says: 

OK 

READY. 

Now the program is ready to be LISTed, RUN, or any other 
operation, just as if you had just typed it all in. 

PROGRAM 1: W RITE-TO-TAPE 

10 PRINT" ^^^ ^ WRITE-TO-TAPE PROGRAM" 
20 OPEN 1,1,1,"DATA FILE- 
SO PRINT"NOW TYPE DATA TO BE" 

40 PRINP'STORED OR TYPE ^ ^^ STOP ffl ^B 
50 PRINT 

60 IN PUT" DATA"; A$ 
70PRINT#1.AS 
80 IFA$<>"STOP"THEN50 
90 PRINT 

100PRINT"CLOSING FILE" 
110 CLOSE 1 
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PROGRAM 2: READ-TAPE USING INPUT# (^ 

10 PRINT' ^^H ^ READ-TAPE PROGRAM" C 

20 OPEN 1,1,0,"DATA FILE" 

30 PRINT"FILEOPEN" 

40 PRINT 

50INPUT#1,A$ 

60 PRINT A$ 

70 IF AS = "STOP'THEN END 

80 GOTO 40 

PROGRAM 3: READ-TAPE USING GET# 

Lines 10 to 40 same as PROGRAM 2 

50GET#1,A$ 

60 IF AS = "'THEN END 

70 PRINT A$,ASC(A$) 

80 GOTO 50 
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APPENDIX C: VIC BASIC 

This manual has given you an introduction to the BASIC language, 
just enough for you to get a feel for computer programming and some 
of the vocabulary involved. This appendix gives a complete list of the 
rules (SYNTAX) of the VIC BASIC language, along with a concise 
description of each. You are encouraged to experiment with these 
commands, remembering that you can't do any permanent damage to 
the VIC by just typing in programs, and that the best way to learn 
computing is by doing. 

This appendix is divided into sections according to the different types 
of operations in BASIC. These include: 

1. Variables and Operators: describes the different types of variables, 
legal variable names, and arithmetic and logical operators. 

2. Commands: describes the commands used to worl< with programs, 
edit, store, and erase them. 

3. Statements: describes the BASIC program statements used in 
numbered lines of programs. 

4. Functions: describes the string, numeric, and print functions. 

The commands in each section are listed alphabetically for conve- 
nience. A fuller explanation of VIC BASIC commands is provided in 
the VIC Programmer's Reference Guide, available where you bought 
your VIC. 



1. VARIABLES & OPERATORS 

a. VARIABLES 

The VIC uses three types of variables in BASIC. These are: normal 
numeric, integer numeric, and strmg (aipiianumeric} variables. 

Normal numeric variables, also called floating point variables, can 
have any value from - 10'* to + 10=", with up to nine digits of 
accuracy. When a number becomes larger than nine digits will show, 
as in 10'° or 10", the computer will display it in scientific notation 
form, with the number normalized to 1 digit and eight decimal places, 
followed by the letter E and the power of ten by which the number is 
multiplied. For example, the number 12345678901 will be displayed as 
1.23456789E + 11. 

integer variables, are used when the number will always be between 
+ 32767 and -32768, and without fractional parts. Integer variables 
require less memory space than floating point variables, but the 
difference probably would not be substantial unless used in a large 
quantity such as an array (see below). An integer variable would be a 
number like 5, 10, or -100. 

String variables, are those used for character data, which may 
contain numbers, letters, and any other character that the VIC can 
make. An example of a string variable is "VIC20." 
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EXAMPLES: 

Numeric Variable Names: A, A5, BZ 
integer Variabie Names: A%, A5%, BZ% 
String Variabie Names: A$, A5$, BZS 



c 
c 

Variabie names may consist of a singie ietter, a fetter foiiowed by a f 
number, or two letters, ^ 

An integer variable is specified by using the percent (%) sign after 
the variable name. String variables tiave the dollar sign ($) after C 

their names. 

c 

c 
c 

Arrays, are lists of variables with the same name, using an extra 

number to specify which is which. They are defined using the DIM C 

statement, and may contain floating point, integer, or string ^ 

variables. The array variable name is followed by a set of 9 

parentheses ( ) enclosing the number of the variable in the list. f 

EXAiyPLES: A(7KBZ%(11),A${87}. ^ 

Arrays may have more than one dimension. A two dimensional array r 
may be viewed as having rows and columns, with the first number 
meaning which row and the second number in the parentheses mean- C 
ing which column. 

EXAMPLES: A(7,2),B2%(2,3,4),Z$(3,2) ^ 

There are three variable names which are reserved for use by the VIC, r 
and may not be used for a normal purpose. These are the variables 

ST, Ti, and Tl$. ST is a status variable which relates to input/output Q 
operations. The value of ST will change if there is a problem loading a 

program or data from the tape or disk. A more detailed explanation of ( 

ST is in the VIC BASIC Programmer's Reference Manual. ^ 

w 

TI and Tl$ are variables which relate to the real-time clock built into ^ 

the VIC. The variabie Ti is updated every 1/60th of a second. It starts ^ ' 

at when the VIC Is turned on, and is reset only by changing the r 

value of Tl$. ^ 

Tl$ is a string which is constantly updated by the system. The first 

two characters contains the number of hours, the 3rd and 4th C 

characters are the number of minutes, and the 5th and 6th characters ^ 

are the number of seconds. This variable can be given any value (so ^- 

long as alt characters are numbers), and wiil be updated from that -^ 

point automatically. ^ 

EXAMPLE: Tl$^ "101530" sets the clock to 10:15 and 30 seconds (AM) C 

This clock is erased when the VIC is turned off, and starts at zero Ti 

when the VIC is turned back on. 

c 
c 
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b. OPERATORS 

The arithmetic operators include the following signs: 

+ addition 

— subtraction 

* multiplication 

/ division 

T raising to power (exponentiation) 

On a tine containing more than one operator, there is a set order in 
which operations always occur. If several operators are used together, 
the computer assigns priorities as follows: First, exponentiation. 
Next, multiplication and division, and last, addition and subtraction. If 
you want these operations to occur in a different order, VIC BASIC 
allows you to isolate a calculation by putting 

parentheses around it. Operations enclosed in parentheses will take 
place before other operations. Be sure that your formulas have the 
same number of left parentheses (as right parentheses), or your 
program will get a SYNTAX ERROR message when run. 

There are also operators for equalities and inequalities: 

= is equal to 

< is less than 

> is greater than 

< = or = < is less than or equal to 

> = or = > is greater than or equal to 

< >or > < is not equal to 

Finally, there are three logical operators: 

AND 

OR 

NOT 

These are used most often to join multiple formulas in IF... THEN 
statements, 

EXAMPLE: 

IF A = BAND G = DTHEN 100 requires both A = B &C = D to be true. 

IF A = B OR C = D THEN 100 Allows either A = B or C = D to be true. 

2. COMMANDS 

CONT (Continue) 

This command is used to re-start the execution of a program which 
has been stopped by either using the STOP key, a STOP statement, or 
an END statement within the program. The program will re-start at the 
exact place from which it left off. 
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CONT will not work If you have changed or added lines oi the program C 
(or even just moved the cursor to a program line and hit RETURN 
without changing anything), or if the program halted due to an error, ( 
or if you caused an error before trying to re-start the program. The 
message in this case is CAN'T CONTINUE ERROR, 



LIST 



C 



( 

c 
c 

The LIST command allows you to look at lines of a BASIC program C 
that have been typed or LOADed into the VIC'S memory. When used 
alone without any numbers following it you will see a complete listing 
of the program on your screen (which may be slowed down by holding 
down the CTRL key or STOPped by hitting the key marked RUN 

STOP). If you follow the word LIST with a line number, the VIC will r 
onJy show you that line number. If you type LIST with 2 numbers 

separated by a dash, the VIC will show all lines between the first and (^ 
second line number. If you type LIST followed by a number and just a 

dash, it will show all the lines from that number to the end of the pro- C 
gram. And if you type LIST, a dash, and then a number, you will get all 

the lines from the beginning until that line number. Using these varia- C. 

tions, you can examine any portion of a program, or bring lines to the *- 

screen for modification. ^ 

EXAIWPLES: ^ 

LIST Shows entire program. 

LIST 10— Shows only from line 10 until the end. ^ 

LIST 10 Shows only line 10. ^ 

LIST— 10 Shov/s lines from the beginning untff line 10. m 

LIST 10—20 Shows lines from 10 to 20, inclusive. ^ 

LOAD abbrev. L sh O 

This is the command to use when you have a program stored on f 

cassette tape or on disk, and you want to use it. If you type just the ^ 

LOAD and hit the RETURN key, the VIC will find the first program on r 
the cassette tape and bring it into memory, to be RUN, LISTed, or 

whatever. You can also type the word LOAD followed by a program Q 
name, which is most often a name in quotes (""). The name may be 

followed by a comma (outside of any quotes) and a number or C 

numeric variable, which acts as a device number to determine where , 

the program is coming from. If there is no number given, the VIC C 

assumes device #1, which is the cassette tape recorder. ^ 

The other device commonly used with the LOAD command is the disk p 
drive, which is device #8, 
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EXAMPLES: 

LOAD Reads in the next program on tape 

LOAD "HELLO" Searcties tape for program called HELLO, and 
loads if found. 

LOAD A$ Looks for a program whose name is in the 

variable called A$. 

LOAD "HELL0",8 Looks for the program called HELLO on the disk 
drive. 

LOAD"*",8 Looks for ttie first program on ttie disk. 

The LOAD command can be used w^ithiin a BASIC program to find and 
RUN the next program on a tape. 

NEW 

This command erases the entire program in memory, and aiso clears 
out any variables that may have been used. Unless the program was 
previously stored somewhere, it is lost until you type it in again. BE 
CAREFUL when you use this command! 

The NEW command can also be used as a statement in a BASIC pro- 
gram. When the VIC gets to this line, the program is erased and every- 
thing stops. It is useful if you want to leave everything neat when the 
program is done. 



RUN 

Once a program has been typed into memory or LOADed, the RUN 
command is used to make it start working. If there is no number 
following the command RUN, the computer will start with the lowest 
numbered program line. If there is a number, that becomes the line 
number where the program starts from. 

EXAMPLES: 

RUN Starts program working from lowest line number. 

RUN 100 Starts program at line 100. 

RUN X UNDEFINED STATEMENT ERROR (you must always type 
RUN by Itself or with a line number - not with a letter). 

SAVE 

This command will store a program currently in memory on a cassette 
tape or disk. If you just type the word SAVE and hit return, the 
machine will attempt to store the program on the cassette tape. It has 
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no way of checking that there is aiready a program on that spot, so be 
careful with your tapes. If you type the SAVE command followed by a 
name in quotes or a string variable name, the VIC will give the pro- 
gram that name, so it may be more easily located and retrieved in the 
future. The name may be followed by a comma (after the quotes) and 
a number or numeric variable. This number tells the VIC which device 
on which to store the program. Device number 1 is the tape drive, and 
#8 is the disk. After the number there can be a comma and a second 
number, which is either or 1. If the second number ts 1, the VIC will 
put an END-GF-TAPE marker after your program. If you are trying to 
LOAD a program and the VIC finds one of these markers, you will net 
a FILE NOT FOUND ERROR. 



EXAMPLE: 

SAVE 

SAVE "HELLO" 

SAVE AS 

SAVE "HELL0",8 



Stores program to tape without a name. 
Stores on tape with the name HELLO. 
Stores on tape with name in variable A$. 
Stores on disk with name HELLO 



SAVE "HELL0",1,1 Stores on tape with name HELLO and foUows 
program with an END-OF-TAPE marker. 



VERIFY 

This command causes the VIC to check the program on tape or disk 
against the one in memory. This is proof that the program you just 
SAVEd is really saved, in case your tape is bad or something isn't 
working. This command is also very useful for positioning a tape so 
that the VIC will write after the last program on the tape. All you do is 
tell the VIC to VERIFY the name of the last program on the \a^e. It will 
do so, and tell you that the programs don't match (which you already 
knew). Now the tape is where you want it, and you can store the next 
program without any fear of erasing an old one. 

VERIFY without anything after the command causes the VIC to check 
the next program on tape, regardless of its name, against the program 
now in memory. VERIFY followed by a program name (in quotes) or a 
string variable will search the tape for that program and then check. 
VERIFY followed by a name and a comma and a number will check 
the program on the device with that number (1 for tape, 8 for disk), 

EXAMPLE: 

VERIFY Checks the next program on the tape. 

VERIFY "HELLO" Searches for HELLO, checks against memory. 

VERIFY "HELL0",8 Searches for HELLO on disk, then checks. 



( 

c 
( 

( 
c 
( 
( 
c 



c 
c 



c 
c 
c 
c 
c 
( 

( 

c 
c 

c: 
c 
c 
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3. STATEMENTS 

CLOSE 

This command completes and closes any files used by OPEN 
statements. The number following the word CLOSE is the file number 
to be closed. 

EXAMPLE: 

CLOSE 2 Only file K is closed. 



CLR 

This command wilf erase any variables in memory, but leaves the pro- 
gram itself intact. This command is automatically executed when a 
RUN command is given. 



CMO 

CtvID sends the output which normally vJou\d go to the screen (i.e. 
PRINT statements, LISTS, but not POKEs into the screen) to another 
device instead. This could be a printer, or a data file on tape or disk. 
This device or file must be OPENed first. The CMD command must be 
followed by a number or numeric variabSe referring to the file. 

EXAMPLE: 

OPEN 1,4 OPENS device #4, which is the printer. 

CMD 1 All normal output now goes to the printer. 

LIST The LISTing goes to the printer, not the screen— even the 

word LIST that you typed 1 

To start sending back to the screen normally, just CLOSE the file. 



DATA 

This statement is followed by a list of items to be used by READ 
statements. The items may be numbers or words, and are separated 
by commas. Words need not be inside of quote marks, unless they 
contain any of the following characters: SPACE, colon, or comma. If 
two commas have nothing between them, the value will be READ as a 
zero for a number, or an empty string, 

EXAMPLE OF A DATA STATEMENT: 

DATA 100,200,FRED, "HELLO, MOM"„3.14,abc123 
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Since the program never needs to actually execute a DATA statement 
in order to read ihe Information, it is a good Idea to put your DATA 
statements as close to the last line of the program as possible. This 
will help your programs run faster. 

DEF FN (Define Function) 

This command allows you to define a complex calculation as a func- 
tion with a short name. In the case of a long formula that is used 
several times during a program, this can save lots of space. 

The name you give the function will be the letters FN and any legal 
variable name (1 or 2 characters long). First you must define the func- 
tion by using the statement DEF followed by the name you have given 
the function. Following the name is a set of parentheses with a 
numeric variable (in this case X) enclosed. Then you have an equal 
sign, followed by the formula you want to define. You can "call" the 
formula, substituting any numberjorXj^using Uie_format shown in line 
20 of the example below: 

EXAMPLE: 

10 DEF FNA(X) = 12-(34.75-X/.3) 

20 PRINT FNA(7) 




c 

c 
( 
( 
c 
c 
c 
c 

c 
c 
c 



DIM (Dimension an array) 

Before you get to use arrays of variables, unless there are 11 or fewer 
elements, the program must first execute a DIM statement for that 
array. The statement DIM is followed by the name of the array, which 
may be any legal variable name. Then, enclosed in parentheses, you 
put the number (or numeric variable) of elements in each dimension. 
An array with more than one dimension is called a matrix. You may 
use any number of dimensions, but keep in mind that the whole list of 
variables you are creating takes up lots of room, and it is easy to run 
out of memory if you get carried away. To figure the number of 
variables created with each DIM, multiply the total number of 
elements in each dimension of the array. 

EXAMPLE; 



10 DIM A$(40),B7{15) 
,41 Elements 



You can dimension more than one array in a DIM statement by 
separating the arrays by commas. Be careful not to let the program 
execute a DIM statement for any array more than once, or you'll get 
an error message. It is a good idea to keep DIMs near the beginning 
of the program. 
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END 

When the program hits a line with the END statement, the program 
stops RUNning as if it ran out of lines. You may use the CONT com- 
mand to re-start the program. 



FOR. ..TO. ..STEP 

This statement works with the NEXT statement to set up a section of 
the program that repeats for a set number of times. You may just 
want the VIC to count up to a large number so the program will pause 
for a few seconds, or you may need something counted. These are 
among the most commonly used statements in BASIC. 

The format of the statement is as follows: 

FOR (loop variable name) = (start of count) TO [end of count). The 
loop variable is a variable which will be added or subtracted to during 
the program. The start of count and end of count are the limits to the 
value of the loop variable. 

The logic of the FOR statement is as follows. First, the loop variable 
is set to the start of count value. The end of count value is saved for 
later reference by the VIC. When the program reaches a line with the 
command NEXT, it adds one to the value ot the loop variable and 
checks to see if it is higher than the end of loop value. If it is not 
higher, the next line executed is the statement immediately following 
the FOR statement. If the loop vaftable is larger than the end of loop 
number, then the next statement executed will be the one following 
the NEXT statement. 

EXAMPLE: 

lOFOR t. = 1TO10 

20 PRINT L 

30 NEXT L 

40 PRINT "I'M DONE! L = "L 

This program will print the numbers from one to ten on the screen, 
followed by the message I'lVl DONE! L= 11. Do you see why it works? 
If not, try re-reading the paragraph before the example again, and 
tracing through the program one step at a time on paper. 

The end of loop value may be followed by the word STEP and another 
number or variable. In this case, the value following the STEP is 
added each time instead of one. This allows you to count backwards, 
by fractions, or any way necessary. 
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You can set up toops inside one another, Ttils is known as nesting 
loops. You must be careful to nest loops so ttiat ttie later loop to start 
is the earlier one to end. 

EXAMPLE OF NESTED LOOPS: 

10FORL=1 TO 100 

20 FOR A = 5 TO 1 1 STEP 2 

30 NEXT A 

40 NEXT L 




c 
c 

( 

c 
c 
c 
c 

c 



Not correct 




10 FOR L = 


1 TO 100 


20 FOR A = 


5 TO 11 STEP 2 


30 NEXT L 




40 NEXT A 





GET 

Ttie GET statement is a way to get data from the keyboard one 
character at a time. When the GET is executed, the character that was 
typed is received. If no character was typed, then a null (empty) 
character is received, and the program continues. There is no need to 
hit the RETURN key, and in fact the RETURN key can be received with 
a GET. 

The word GET is followed by a variable name, usually a string 
variable. If a numeric were used and any key other than a number was 
hit, the program would stop with an error message. The GET state- 
ment may also be put into a loop, ctiecking for an empty result, which 
will wait for a key to be struck. 



EXANdPLE: 

10GETA$;1FA$ = ""THEN 10 




122 



• 

c 
c 
c 
( 



GET# 

Used with a previously OPENed device or fiie to input one charcter at 
a time. 

EXAMPLE: 

GET#1,A$ 

Q05UB 

Ttiis statement is iike ttie GOTO statement, except that the VfC 
remembers where it came from. When a line with a RETURN state- 
ment is encountered, the program jumps back to the statement im- 
mediately following the GOSUB. This is useful if there is a routine in 
your program that occurs several times in different parts of the pro- 
gram. Instead of typing the same over and over, you type it once and 
GOSUB to it from the different parts of tfie pfogram. 20 GOSUB 800 
means go to the subroutine beginning at line 800 and execute it. 



GOTO or GO TO 

When a statement with the GOTO command is reached, the next line 
to be executed will be the one with the line number following the word 
GOTO, 



IF.. .THEN 

The IF.. .THEN statement lets your VIC analyze a situation and take 
two possible courses of action depending on the outcome. If the ex- 
pression being evaluated is found to be true, the statement following 
the word THEN is executed. This may be a line number, which will 
cause the VIC to GOTO that line of the program. It may also be any 
other BASIC statement or statements. If the expression is false, then 
the next line {not the next statement on the same line) is executed 
instead. 

The expression being evaluated may be a variable or formula, in which 
case it is considered true if non-zero, and false if zero. In most cases, 
there is an expression involving the relational operators ( = , , , =, = , 
,AND,OR,NOT). ff the result is found to be true, it has a value of - 1, 
and a value of if false. See the section on relational operators for an 
explanation of how this works. 
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INPUT 



INPUT«f 

This works like iNPUT, but lakes the data from a previousiy OPENed 
lile or device. 
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The iNPUT statement aiiows the computer to get data into a variable r 
from the person running the program. The program wiil stop, print 
a question mark (?) on the screen, and wait for the person to type the (^ 
answer and hit the RETURN key. 



The work INPUT is followed by a variable name or list of variable 

names separated by commas. There may be a message inside of y 

quotes before the list of variables to be input. If this message (called 

a prompt) is present, there must be a semicolon (;) after the last quote 

of the prompt. When more than one variable is to be INPUT, they f 

should be separated by commas when typed in, 

EXAI^PLE: 

10 INPUT"PLEASE TYPE A #";A 

20 INPUr'AND YOUR NAME";A$ 

30 INPUT B$ 

40 PRINT"BET YOU DIDNT KNOW WHAT I WANTED!" 



c 

c 



LET 

The word LET itself is hardly ever used in programs, since it is op- 
tional, but the statement is the heart of all BASIC programs. The 
variable name which is to get the result of a calculation is on the left 
side of the equal sign, and the number or formula is on the right side. 

EXAMPLE: 

10LETA = 5 I 

20 B = 6 . ( 

30C = A-B + 3 ( 

40 D$ = "HELLO" 



c 
( 

( 
( 
c 

c 



NEXT 

The NEXT statement is always used in conjunction witti ttie FOR 
statement. When the program gets up to a NEXT statement, it goes 
back to the FOR statement and checks the loop. (See FOR statement 
for more detail.) If the loop is finished, execution proceeds with the 
statement after the NEXT statement. The word NEXT may be followed 
by a variable name, or a list of variable names, separated by commas. 
If there are no names listed, the last loop started is the one being 
completed. If the variables are given, they are completed in order form 
left to right. 

EXAMPLE: 

10 FOR L = 1TO10;NEXT 

20FORL = 1TOlO:NEXTL 

30 FOR L = 1 TO 10:FOR M = 1 TO 10:NEXT M,L 

ON 

This command can make the GOTO and GOSUB commands into 
special versions of the IF statement. The word ON is followed by a 
formula, which is evaluated into a number. The word GOTO or GOSUB 
is followed by a list of line numbers separated by commas. If the 
result of the calculation is 1, the first line in the list is executed. If the 
result is 2, the second line number is executed, and so on. If the result 
is 0, negative, or larger than the list of line numbers, the next line 
executed will be the statement following the ON statements. 

EXAMPLE: 

10 INPUT X 

20 ON X GOTO 10,50,50,50 

30 PRINT "NOPE!" 

40 GOTO 10 

50 PRINP'YUP!" 

60 ON X GOTO 10,30,30 
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OPEN e 

The OPEN statement allows the VIC to access devices such as the (^ 
cassette recorder and disk for data, a printer, or even the screen of 

the VIC. The word OPEN is followed by a number, which is the C 
number to which all other BASIC statements will refer. This number is 

from 1 to 255. There is usually a second number after the first, ( 

separated by a comma. This is the device number, for the VIC , 

screen, 1 for the cassette recorder, 4 for the printer, 8 for the disk. It is ^ 

a good idea to use the same reference number as the device number, /- 
which makes it easy to remember which is which. Following the 

second number may be a third number, separated again by a comma, (^ 
which is the secondary address. In the case of the cassette, this may 

be for read, 1 for write, and 2 for write with end-of-tape marker at the ( 
end. In the case of the disk, the number refers to the buffer, or charv- 

nel, number. In the printer, the secondary addresses become different ( 

types of commands. See the VIC Programmers' Reference Manual for ^ 

more on these. There may also be a string following the third number, ^ 

which would be a command to the disk drive or the name of the file ^ 
on tape. 

EXAMPLE: ' 

10 OPEN 1,0 OPENS the SCREEN as a device. 

20 OPEN 2,1,0,"D" OPENS the cassette for reading, file to be ^ 

searched for is named D. w 

m 

30 OPEN 3,4 To use the printer. ^ 

40 OPEN 4,8,15 OPENs the data channel on the disk. 

c 

See also: CLOSE, CMD. GET#, INPUT#, and PRINTS statements, 

system variable ST, and Appendix B. C 



POKE ^ 

The POKE command is always followed by two numtiers, or formulas, r 
The tirst number is a location inside the VIC's memory. There could 

be locations numbered from to over 65000. Some of these, like the Q 
ones described in the chapters on sound and colors, can be used 

easily in your programs. Some, however, are used by the VIC itself, C 

to keep track of your programs and so on. Experimenting with the ^ 

POKE statement will probably result in some interesting effects. If v 

something happens and you can't stop it, just turn the VIC off and on /- 

again, or hold down the RUN /STOP key and hit RESTORE. '^ ' 
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The second number is a value from to 255, which wiil be placed in 
the memory location, replacing any value that was there previously. 

EXAMPLE; 

10 POKE 36879,8 

20POKE9*16T 3 + 15,27 

PRINT 

The PRINT statement is the first one most people learn to use, but 
there are lots of subtleties to be mastered here as well. The word print 
can be followed by any of the following things: 

Words inside of quotes 
Variable names 
Functions 
Punctuation marks 

The words inside of quotes are often called literals because they are 
printed literally as they are typed in. Variable names outside of quotes 
will have the value they contain printed. Functions will have their 
values printed also. Punctuation marks are used to help format the 
data neatly on the screen. The comma is used to divide the screen in- 
to 2 columns, while the semicolon doesn't leave any space at all. 
Either mark can be used as the last symbol in the statement. This 
results in the next thing PRINTed coming out as if it were continuing 
the same PRINT statement. 

EXAMPLE: 

10 PRINT "HELLO" 

20 PRINT -HELLO, "AS 

30 PRINT A + B; 

50 PRINT J; 

60 PRINT A,B,C,D 

See also: POS( ), SPC( ), TAB( ) functions. 

PRINT# 

There are a few differences between this statement and the PRINT. 
First of all, the word PRINTff is followed by a number, which refers to 
the device or data file previously OPENed. The number is followed by 
a comma, and a list of things to be PRINTed. The comma and 
semicolon have the same effect on adding spaces as they do in the 
PRINT, but some devices may not work with TAB and SPG. 
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( 
( 

EXAMPLE: ( 

100 PRINT#1, "HELLO THERE! ■';A$,B$ C 

c 
c 

c 



READ 



This statement is used to get information from DATA statements into 
variables, where ttiey may be used. Care must be taken to avoid 

reading strings vi/here the READ statement wants a number, w/hich r 

will give you a TYPE MISMATCH ERROR. ^ 

c 

REM (remark) C 

The REMark is just a note to whoever is reading a LIST of the pro- C 

gram. It may explain a section of the program, give information about ^ 

the author, etc. REM statements in no way effect the operation of the ^ 

program, except to add to its length. The word REM may be followed f 
by any text, although use of graphic characters will give strange 

results (see the VIC PROGRAMMER'S REFERENCE GUIDE for (^ • 
more info.) 

c 



RESTORE 



RETURN 



program can be re-started by using the CONT command. The STOP 
statement is used for debugging a program. 

SYS 
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c 

c 



When executed in a program, the pointer to which item in a DATA 
statement witi be read next is reset to the first item in the list. This 
gives you the ability to re-READ the information. The word RESTORE 
stands by itself on the line. f 

c 

c 
c 
c 



This statement is always used in conjunction with the GOSUB state- 
ment. When the program hits a RETURN statement, it will go to the 
statement irr.mediately following the GOSUB command. If no GOSUB 
was previously issued, there is a RETURN WITHOUT GOSUB ERROR. 
There is nothing folfowing the word RETURN. ( 

c 

STOP 

This statement will halt the program. A message, BREAK ERROR IN , 

LINE xxxx, where xxxx is the tine number containing the STOP, The ' 



c 



The word SYS is followed by a decimal number or numeric variable in 
the range 0-65535. The program will at this point begin executing the 
machine language program starting at that memory location. This is ( 

similar to the USR function, but does not allow parameter passing. 



c 



C ' 



WAIT 

The WAIT statement is used to halt the program until the contents of 
a location in memory changes in a specific way. The word WAIT is 
followed by a number, whicti is the memory address being checked. 
Then comes a comma, and another number. There may be another 
comma and a third number as well. These last two numbers must be 
within the range 0-255. 

The contents of the memory location are first exclusive-ORed with the 
third number, if present, and then logically ANDed with the second 
number. If the result is zero, the program goes back to that memory 
location and checks again. When the result is non-zero, the program 
continues with the next statement. 



4. FUNCTIONS 
a. NUMERIC 

ABS(X) (absolute value) 

The absolute value returns the value of the number, without it's sign 
(- or +). The answer is always positive. 



ATN(X) (arctangent) 

Returns the angle, measured in radians, whose tangent is X. 

COS(X) (cosine) 

Returns the value of the cosine of X, where X is an angle measured in 
radians. 

EXP(X) 

Returns the value of the mathematical constant e (2,71827183) raised 
to the power of X. 

FNXX(X) 

Returns the value of the user-defined function XX created in a DEF 
FNXX statement. 

INT(X) (Integer) 

Returns the truncated value of X, that is, with all decimal places to 
the right of the decimal point removed. The result will always be less- 
than or equal-to X. Thus, any negative numbers with decimal places 
will become the integer less-than their current value. 
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If the INT function is to be used for rounding up or down, the form is 
INT(X + .5). 

EXAMPLE: 

X = INT(X'100 + .5)/100 Rounds to the nearest penny. 



c 

c 
i 
c 
c 
c 

LOG<X) (logarithm) ^ 

This will return the natural log of X. The natural log is log to the base 

e {see EXP{X)), To convert to log base 10, simply divide by LOG(IO). ( 

PEEK(X) % 

This is used for finding out the contents of memory location X, in the C 
range of 0-65535, giving a result from 0-255. This is often used in con- 
junction with the POKE statement. V 



RND(X) (random number) M 

This function will return a random (or nearly so) number between (^ 
and 1. This is useful in games, to simulate dice rolls and other 

elements of chance, and is also used in some statistical applications. C 

The first random number should be generated by the formula RND(-TI), , 

to start things off differently every time. After this, the number in X ^ 

should be a 1, or any positive number. If X is zero, the result will be f 

the same random number as the last one. A negative value for X will ^ 

re-seed the generator. The use of the same negative number for X will r 
result in the same sequence of "random" numbers. 



To simulate 2 dice, add two of the numbers obtained by the above 
formula together. 



EXAMPLE: 

100 X = [NT{RND(1)*6) -i- INT(RND(1)*6) + 2 Simulate 2 dice. 

100 X = INT(RND(1)*1000) + 1 Number from 1-1000, 



To Simulate the rolling of a die, use the formula INT(RND(1)'6-f 1). 

First the random number from 0-1 is multiplied by 6, which expands C. 

the range to 0-6 (actually, greater than zero and less then six). Then 1 

is added, making the range 1-under 7. The INT function chops off all ^ 

the decimal places, leaving the result as a digit from 1 to 6. ^ 



c 

100X-i-INT(RND(1)*150)-+-100 Number from 100-249. r 



SGN(X) (sign) 

This function returns the sign, as in positive, negative, or zero, of X. 

The result will be -t- 1 if positive, if zero, and - 1 if negative. C_ 
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SIN(X) (Sine) 

This is the trigonometric sine function. The result will be the sine of X, 
wtiere X is an angle in radians. 



SQR(X) (square root) 

This function will return the square root of X, where X is a positive 
number or 0. If X is negative, an ILLEGAL QUANTITY ERROR results. 



TAN(X) (tangent) 

The result will be the tangent of X, where X is an angle in radians. 

USR (X) 

When this function is used, the program jumps to a machine 
language program whose starting point is contained in memory loca- 
tions 1 and 2. The parameter X is passed to the machine language 
program, which will return another number back to the BASIC pro- 
gram. See the VIC PROGRAMMER'S REFERENCE MANUAL for more 
details on this, and on machine language programming. 

b. STRING FUNCTIONS 

ASC(X$) 

This function will return the ASCII code of the first character of X$. 

CHR$(X) 

This Is the opposite of ASG, and returns a string character whose 
ASCII code is X. 

LEFTS(X$,X) 

This will return a string containing the leftmost X characters of X$. 

LEN(X$) 

Returned will be the number of characters (including spaces and 
other symbols) in the string X$. 

MIDS(X$,S,X) 

This will return a string containing X characters, starting from the Sth 
character in XS. 
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R1GHTS(XS,X) 

This will return the rightmost X characters in X$. 

STRS(X) 

This will contain a string which is identical to the PRINTed version of 

A41. 



VAL(X$) 

This function converts the string X$ into a number, and is essentially 
the inverse operation from STRS. The string is examined from the left- 
most character to the right, for as many characters as are in 
recognizable number format. If the VIC finds illegal characters only 
the portion of the string up to that point is converted. 

EXAMPLE: 



10X = VAL("123.456") 


X = 123.456 


10X = VALr 12A13B") 


X = 12 


10X = VAL("RIUO17*") 


X = 


10 X = VAL{"- 1.23.23.23") 


X= -1.23 


c. OTHER FUNCTIONS 




FRe(X) 





This function returns the number of unused bytes available in 
memory, regardless of the value of X. 



i 

This function returns the number of the column (0-21) at which the r 

next PRINT statement will begin on the screen. X may have any value 

- — ' ■ ' ' ' ' J. 

TAB{X) P 



POS(X> 



and is not used. 

SPC(X) 

This Is used in the PRfNT statement to skip X spaces forward. 



This Is used in the PRINT statement. The next item to be printed will 



( 
be in column number X. ' '"" ( 
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APPENDIX D: 

ABBREVIATIONS FOR BASIC KEYWORDS 

As a time saver when typing in programs and commands, VIC BASIC 
allows the user to abbreviate most keywords. The abbreviation tor the 
word PRINT is a question mark. The abbreviations for the other words 
are made by typing the first one or two letters of the key word, 
followed by the SHIFTed next letter of the word. If the abbreviations 
are used in a program line, the keyword will LIST in the longer form. 
Note that some of the keywords when abbreviated include the first 
parenthesis, and others do not. 









Looks llks 






Looks like 


Commind 


A 

A 


bbrevlatlon 


thts on »cr«en 


Command 


AbbisTlillon 


this on *eieen 


AND 


^^1 N 


A 


V 


PRINT# 


P ^^1 n 


P — 


NOT 


N 


^^^^H D 


N 




READ 


R ^^^ E 


r 


CLOSE 


CL 


^^^ 


CL 




RESTORE 


RE^^^ S 


-¥ 


CLR 


C 


^^^ L 


C 




RETURN 


RE ^^^ T 


RE 


CMO 


C 


^^^ M 


c 


N 


RUN 


R ^^^lU 


- \6 


CONT 


C 


^E ^H o 


c 




SAVE 


^^^H A 


s ♦ 


DATA 


D 


^^^H A 


D 


4 


STEP 


ST ^^^1 E 


ST 1 


DEF 





[1^2 E 


D 




STOP 


^^^1 T 


S 


DIM 


D 


^^^1 t 


D 


^ 


sys 


s ^^^1 V 


s 


END 


E 


^^^P N 


E 


/ 


THEN 


^^^1 H 


T 


FOR 


F 


.^^^1 


F 




VERIFY 


V ^^^1 E 


V 


GET 


G 


^^n E 


G 




WAIT 


W ^^S A 


w 4^ 


GOSUS 


GO^^H S 


GC 


>¥ 


ABS 


^^^H B 


A 


GOTO 


G 


^^^H 


G 




ASC 


A ^^^B s 


^ ¥ 


INPLfT* 


1 


^^|n 


t 


V 


ATN 


A ^^St 


A 


LET 


L 


^^2 E 


L 




CHRt 


c ^^n H 


C 


LIST 


L 


^^^^1 1 


L 


^ 


EXP 


£ ^^H X 


^ ♦ 


LOAD 


L 


^^^ 


L 




FRE 


F ^^Hr 


F 


NEXT 


N 


^^1 E 


N 




LEFTS 


LE ^^1 F 


LE 


OPEN 





^^^1 p 


o 




MIDS 


M ^^1 1 


M ^ 


POKE 


P 


^^2 


p 




PEEK 


p ^^He 


P 


PRINT 


? 




7 




RIGHTS 


R ^^^1 1 


^ ~\ 
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Loot! 


llk< 






Looks Ilka \ 


Cotnraind 




Lbbravtilkin 


this on wreen 


Commind 


Abbrxltllon 


this on scf««n 


RND 


^^^1 N 


R 


\A 


SIRS 


ST ^^H R 


"it 


5GN 


S 


^^^B G 


S 


n 


TAB( 


T ^^1 A 


'♦< 


SIN 


S 


^^^1 


S 


bJ 


USR 


u ^^|s 


"*. 


SPC( 


s 


^^^1 p 


s 




VAL 


V ^^^P A 


-♦( 


SQR 


s 


^^^1 Q 


s 


• 
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APPENDIX E 
SCREEN & BORDER COLOR COMBINATIONS 

You can change the screen and border colors of the ViC anytime, in or 
out of a program, by typing 

POKE 36879, X 

where X is one of the numbers shown in the chart below. POKE 36879, 
27 returns the screen to the normal color combination, which is a 
CYAN border and white screen. 



CTRL 






and you 



Try typing POKE 36879, 8, Then type 

have white letters on a totally black screen! Try some other 
combinations. This POKE command is a quick and easy way to 
change screen colors in a program. 



c 
c 

( 



c 
c 
c 













BORDER 








r 




SCREEN 


BLK 


WHT 


RED 


CYAN 


PUR 


GRN 


BLU 


YEL 






SLACK 


8 


9 


10 


11 


12 


13 


14 


15 


(. 




WHITE 


24 


25 


26 


27 


28 


29 


30 


31 


c^ 




RED 


40 


41 


42 


43 


44 


45 


46 


47 




CYAN 


56 


57 


58 


59 


60 


61 


62 


63 


c 




PURPLE 


72 


73 


74 


75 


76 


77 


78 


79 


c 
c 




GREEN 


88 


89 


90 


91 


92 


93 


94 


95 




BLUE 


104 


105 


106 


107 


108 


109 


110 


111 




YELLOW 


120 


121 


122 


123 


124 


125 


126 


127 


c 




ORANGE 


136 


137 


138 


139 


140 


141 


142 


143 




LT. ORANGE 


152 


153 


154 


155 


156 


157 


158 


159 


i 




PINK 


166 


169 


170 


171 


172 


173 


174 


175 


r- 




LT. CYAN 


184 


185 


186 


187 


188 


189 


190 


191 






LT PURPLE 


200 


201 


202 


203 


204 


205 


206 


207 


t 




LT GREEN 


216 


217 


218 


219 


220 


221 


222 


223 


f 




LT. BLUE 


232 


233 


234 


235 


236 


237 


238 


239 
255 






LT. YELLOW 


248 


249 


250 


251 


252 


253 


254 


c 
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c 

( 



APPENDIX F 
TABLE OF MUSICAL NOTES 



APPROX. 




APPROX. 




NOTE 


VALUE 


NOTE 


VALUE 


C 


135 


G 


215 


C# 


143 


m 


217 


D 


147 


A 


219 


D# 


151 


A# 


221 


E 


159 


B 


223 


F 


163 


C 


225 


F# 


167 


C# 


227 


G 


175 


D 


228 


G# 


179 


D# 


229 


A 


183 


E 


^1 


A# 


187 


F 


232 


B 


191 


Rf 


233 


C 


195 


Q 


235 


C# 


199 


G# 


236 


D 


201 


A 


237 


D# 


203 


A# 


238 


E 


207 


B 


239 


F 


209 


C 


240 


F# 


212 


C# 


241 


SPEAKER COMMANDS: 


WHERE X CAN BE: 


FUNCTION: 


POKE 36878, X 




0to15 


sets volume 


POKE 36874, X 




128 to 255 


plays tone 


POKE 36875, X 




128 to 255 


plays tone 


POKE 36876, X 




128 to 255 


plays tone 


POKE 36877, X 




128 to 255 


plays "noise" 



APPENDIX G: 

20 SOUND EFFECTS FOR THE VIC-20 

Here are some sample routines to use as a guide for creating sounds 
to enhance your programs. You may type them into your VIC -20 either 
by themselves or inside other programs. Of course, these are not 
nearly all of the possible sounds that your VIC-20 can play, so feel 
free to use your creativity. 

The sound effects listed here will make a program pause for however 
long they take to be completed. It is possible to put these effects into 
a program in a way that does not stop whatever animation may be 
running, and this topic is discussed in detail in the VIC-20 
Programmer's Reference Manual. 
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Remember to use line numbers when you type these routines into the 
computer. Ttie numbers are not stiown tiers in order to avoid 
confusion wtien you enter ttiem into your programs. 



#1: SCALES 

POKE 36878,15 

FOR L = 250 TO 200 STEP - 2 

POKE36876,L 

F0RM = 1 TO 100 

NEXTM 

NEXT L 

FOR L = 205 TO 250 STEP 2 

POKE 36876,L 

FOR M = 1 TO 100 

NEXTM 

NEXTL 

POKE 36876,0 

POKE 36878,0 

#2: COMPUTER MANIA 

POKE 36878,15 

FOR L=1 TO 100 

POKE 36876,INT{RND(1)-128) + 128 

F0RM = 1 TO 10 

NEXTM 

NEXT L 

POKE 36876,0 

POKE 36878,0 

#3: EXPLOSION 

POKE 36877,220 

FOR L = 15TO0STEP -1 

POKE 36878,L 

FOR M = 1 TO 300 

NEXTM 

NEXTL 

POKE 36877,0 

POKE 36878,0 

#4: BOMBS AWAY 

POKE 36878,10 

FOR L = 230TO128STEP -1 

POKE 36876,L 

FOR M = 1 TO 20 

NEXTM 

NEXTL 

POKE 36876,0 

POKE 36877,200 

FOR L= 15 TOO STEP -.05 

POKE 36878, L 

NEXTL 

POKE 36877,0 
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#5; RED ALERT 

POKE 36878,15 

FOR L = 1 TO10 

FOR M = 180 TO 235 STEP 2 

POKE 36876,M 

FOR N = 1 TO 10 

NEXTN 

NEXT M 

POKE 36876,0 

F0RM = 1 TO 100 

NEXTM 

NEXTL 

POKE 36878,0 

#6: LASER BEAM 

POKE 36878,15 

FOR L = 1 TO 30 

FOR M = 250 TO 240 STEP - 1 

POKE 36876, M 

NEXTM 

FOR M = 240 TO 250 

POKE 36876,M 

NEXTM 

POKE 36876,0 

NEXTL 

POKE 36878,0 

#7: HIGH-LOW SIREN 

POKE 36878,15 
FOR L=1TO10 
POKE 36875,200 
FOR M = 1 TO 500 
NEXTM 
POKE 36875,0 
POKE 36876,200 
FOR M = 1 TO 500 
NEXTM 
POKE 36876,0 
NEXT L 
POKE 36878,0 



( 

c 

i 
c 
c 

( 

( 

c 

c 

( 

( 

c 

• 

c 

c 

( 
c 
< 
c 

o 

( 
( 
c 
c 
i 
c 
( 
c 



#8: BUSY SIGNAL 



#12: OCEAN WAVES 



POKE 36878,15 
F0RL=1T015 
POKE 36876,160 
FOR M = 1 TO 400 
NEXTM 
POKE 36876,0 
FOR M = 1 TO 400 
NEXTM 
NEXTL 
POKE 36878,0 

#9: PHONE RINGING 

POKE 36878.15 
FOR L = 1 TO 5 
FOR M = 1 TO 50 
POKE 36876,220 
FOR N = 1 TO 5 
NEXTN 
POKE 36876,0 
NEXT M 

FOR M = 1 TO 3000 
NEXT M 
NEXTL 
POKE 36878,0 

#10: BIRDS CHIRPING 



POKE 36877,180 

FOR L=1 TO10 

D = INT{RND(1)*5)'5O + 50 

FOR M ^3 TO 15 

POKE 3687e,M 

FOR N = 1 TO D 

NEXT N 

NEXTM 

FORM = 15 TO 3 STEP -1 

POKE 36878.M 

FOR N = 1 TO D 

NEXTN 

NEXTM 

NEXTL 

POKE 36878,0 

POKE 36877,0 

#13: VANISHING UFO 

POKE 36878,15 
FOR L=130TO254 
POKE 36876, L 
FOR M = 1 TO 40 
NEXTM 
NEXTL 
POKE 36878,0 
POKE 36876,0 



POKE 36878,15 

FOR L = 1 TO 20 

FOR M=254TO240 + iNT(RND(1)M0)STEP -1 

POKE36876,M 

NEXTM 

POKE 36876,0 

FOR M=0TO INT(RND(1)*100) + 120 

NEXTM 

NEXTL 



#11: WIND 

POKE 36878,15 
POKE 36874.170 
POKE 36877.240 
FOR L = 1 TO 2000 
NEXTL 
POKE 36874,0 
POKE 36877,0 
POKE 36878,0 



#14: UFO LANDING 

POKE 36878,15 

FOR L=1 TO20 

FOR M = 220-L TO 160-L STEP - 4 

POKE 36876, M 

NEXTM 

FOR M = 160-L TO 220-L STEP 4 

POKE 36876, M 

NEXTM 

NEXT L 

POKE 36878,0 

POKE 36876,0 
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^ 







c 


#15: UFO SHOOTING 


#19: DOOR OPENING 


c 


POKE 36878,15 


POKE 36878,15 


( 


F0RL=1T0 15 


B = 


FORM = 200TO220 + L*2 


FORL=128T0 255STEP11 


( 


POKE 36876,M 


POKE 36874,L 


NEXTM 


FOR M = 1 TO 10 


c 


NEXTL 


NEXTM 


POKE 36878,0 


B = B + 1 


( 


POKE 36876,0 


IF B = 3 THEN B = 0: POKE 36874,0 






NEXTL 


( 


#16: WOLF WHISTLE 


POKE 36874,0 






POKE 36878,0 


c 


POKE 36878,15 






FOR L = 148 TO 220 STEP .7 


#20: BLIPS 


c 


POKE 36876,L 




^ 


NEXT L 


POKE 36878,15 


c 


FOR L = 128 TO 200 


POKE 36876,220 


c 


POKE 36876,1 


F0RL=1 TO 5 


NEXTL 


NEXTL 


• 


FOR L = 200TO 128 STEP -1 


POKE 36876,0 


POKE 36876, L 


FOR L = 1 TO 500 


• 


NEXT L 


NEXT L 


POKE 36878,0 


POKE 36876,200 


• 


POKE 36876.0 


FOR L=1 TO 5 






NEXTL 


c 


#17: RUNNING FEET 


POKE 36876,0 


( 




FOR L = 1 TO 500 


POKE 36878,15 


NEXT L 




FOR L=1 TO 10 


POKE 36878,0 


c 


POKE 36874,200 




( 


F0RM = 1 TO 10 




NEXTM 




c 


POKE 36874,0 




FOR M = 1 TO 100 




( 


NEXTM 




NEXTL 




c 


POKE 36878,0 






#18:TICK-TOCK 






POKE 36878.15 




m 


F0RL = 1T0 10 




c 


POKE 36875,200 






FOR M = 1 TO 10 




( 


NEXTM 




c 


POKE 36875.0 




FOR M = 1 TO 300 




c 


NEXTM 




POKE 36874,200 




( 


FOR M = 1 TO 10 




NEXTM 




% 


POKE 36874,0 






FOR M = 1 TO 300 




• 


NEXTM 






NEXT L 




• 


POKE 36878.0 




f 
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APPENDIX H: SCREEN DISPLAY CODES 

The following chart lists all of the characters built-in to the VIC20 
character sets. They show which numbers should be POKEd into 
screen memory {locations 7680 to 8185) to get a desired character. 
Also, it shows what character corresponds to a number PEEKed from 
the screen. 

The two character sets are available, but only one set at a time. This 
means that you cannot have characters from one set on the screen at 
the same time you have characters from the other set displayed. The 
sets are switched by holding down the SHIFT and CONdMODORE keys 
simultaneously. This actually changes the 2 bit in memory location 
36869, which means that the statement 

POKE 36869, 240 will set the character set to upper case, and POKE 
36869, 242 switches to lower case. 

If you want to do some serious animation, you will find that it is 
easier to control objects on the screen by POKEing them into screen 
memory (and erasing them by poking a 32, which is the code for a 
blank space, into the same memory location), than by PRINTing to the 
screen by using cursor control characters. 

Any number shown on the chart may also be displayed in REVERSE. 
Reverse characters are not shown, but the reverse of any character 
may be obtained by adding 128 to the numbers shown. 

NOTE: SEE SCREEN MEf^ORY MAP APPENDIX. 

If you want to display a heart at screen location 7800, find the number 
of the character you want to display there (in this case a heart) in this 
chart. ..the number for the heart is 83. ..then type in a POKE statement 
with the number of the screen location (7800) and the number of the 
symbol (83) like this: 

POKE 7800, 83 

A white heart should appear in the middle area of the screen. Note 
that it will be invisible if the screen is white. Try changing the position 
by changing the larger number, or type in different symbols using the 
numbers from the chart. 

If you want to change the COLOR of the symbol being displayed, 
consult the accompanying chart which lists the COLOR NUMBERS 
for EACH MEMORY LOCATION. In other words, to get a different 
colored symbol at a particular location, this requires another POKE 
command. 
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For example, to get a red heart, type the following 

POKE 38520, 2 




This changes the color of the symbol at location 7800 to red. If you 
had a different symbol there, that symbol would now be red. You can 
display any character in any of the available colors by corribining Q 

these two charts. These POKE commands can be added in your 
programs and are very effective especially in animation — and also O 

provide a means to PEEK at certain locations if you are doing 
sophisticated programming such as bouncing a ball, which requires 
this information. 
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SCREEN CODES 



SET 1 SET 2 POKE 

@ 

A a 1 

B b 2 

C c 3 

D d 4 

E e 5 

F f 6 

G g 7 

H h 8 

I i g 

J j 10 

K k 11 

L I 12 

M m 13 

N n 14 

O o 15 

P p 16 

Q q 17 

R r 18 

S s 19 

T t 20 



SET1 SET 2 POKE 

U u 

V V 
W w 
X X 

Y y 
Z z 



# 
$ 



DKE 


SET 1 SET 2 POKE 


21 


* 


42 


22 


+ 


43 


23 


, 


44 


24 


— 


45 


25 




46 


26 


/ 


47 


27 





48 


28 


1 


49 


29 


2 


50 


30 


3 


51 


31 


4 


52 


32 


5 


S3 


33 


6 


54 


34 


7 


55 


35 


8 


56 


36 


9 


57 


37 


: 


58 


38 


; 


m 


39 


< 


60 


40 


= 


61 


41 


> 


62 



c 
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SET1 SET 2 POKE 


SET 1 SET 2 POKE 


SET1 SET 2 POKE 




7 




63 


\ 


T 


84 


n 


106 




\- 




64 


1 

1^ 


U 


85 


h 


107 




4 


A 


65 


X 


V 


86 


J 


108 




1 


B 


66 


P 


w 


87 


M 


109 




— 


C 


67 


♦ 


X 


88 


n 


110 






D 


68 




Y 


89 


^ 


111 




E 


69 


♦! 


z 


90 


r 


112 






F 


70 


h- 




91 


rn 


113 


c 




G 


71 


!ii 




92 


1 


114 






H 


72 






93 


1 

r 


115 




X. 


1 


73 


•|r 


!X 


94 


IJ 


116 




^ 


J 


74 


3 


ss 


95 


II 


117 




J 


K 


75 


^g 


96 


J 


118 




u 


L 


76 


K 




97 


n 


119 


\ 


M 


77 


y 




98 


n 


120 




/I 


N 


78 


n 




99 


^ 


121 









79 






100 


U v^ 


122 






P 


80 


1 




101 


kj 


123 




• 


Q 


81 


Sii 




102 


n 


124 






R 


82 


i ^ 




103 


n 


125 




¥ 


S 


83 


^ 




104 


Fl 


126 










n 


}fi 


105 


s 


127 


c 
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APPENDIX 1: SCREEN MEMORY MAPS 

Use this appendix to find the memory location of any position on the 
screen. Just find the position in ttie grid and add the numbers on the 
row and coiumn together. For example, if you want to poke the 
graphic "ball" character onto the center of the screen, add the 
numbers at the edge of row 11 and column 11 (7900 + 10) for a total of 
7910. If you poke the code for a ball (81, see Appendix H) into location 
7910 by typing POKE 7910,81, a white ball appears on the screen. To 
change the color of the ball (or other character), find the correspond- 
ing position on the color codes memory map, add the row and column 
numbers together (38620 + 10, or 38630) for the color code and type a 
second poke statement. For example, if you poke a color code into 
this location, POKE 38630,3 the bait will change color to cyan. Note 
that when POKEing, the character color numbers are one less than 
the numbers on the color keys— as shown below. 



reviate( 


j List of Color Codes 


Code 


Color 





Black 


1 


White 


2 


Red 


3 


Cyan 


4 


Purple 


5 


Green 


6 


Blue 


7 


Yellow 
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2 


3 


4 


5 


6 


7 


8 


9 


1011 


1213 14 15 


16 17 18 19 20 21 


7680 














































7702 












































7724 














































7746 














































7768 














































um 












































7812 














































7834 










































7856 














































7878 












































~ 


7900 








































7922 














































7944 










































7966 












































7988 














































8010 














































8032 














































8054 














































8076 














































8098 














































8120 














































8142 














































8164 
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38400 





1 


2 


3 


4 


5 


6 


7 


e 


9 


10 11 


12 13 14 15 16 17 18 19 20 21 


1 










































38422 














































38444 














































38466 
38488 


























































































38510 














































38532 












































— 


38554 




































— 


— 


— 




38576 




































38598 . 










































38620 _ 












































38642 „ 










































— 


38664 _ 










































38686 
38708 
38730 






















































































- 












































38752 














































38774 












































38796 














































38818 












































38840 














































38862 












































38884 




_ 






















1 


I 
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APPENDIX J: ASCII AND CHR$ CODES 

This appendix shows you what characters will appear if you 
PRINT CHRS (X), for all possible values of X. It will also show the 
values obtained by typing PRINT ASC ("x") where x is any character 
you can type. This is useful in evaluating the character received in a 
GET statement, converting upper/iower case, and printing character- 
based commands {like switch to upper/lower case) that couid not be 
enclosed in quotes. 



PRINTS CHRS 


PRINTS 


CHRS 


PRINTS < 


:hr$ 


PRINTS 


CHRS 







16 


^^^9 


32 





48 


1 


@ 


17 


1 


33 


1 


49 


2 




18 


" 


34 


2 


50 


3 


BTl 


19 


# 


35 


3 


51 


4 




20 


s 


36 


4 


52 


^^3 5 




21 


% 


37 


5 


53 


6 




22 


& 


38 


6 


54 


7 




23 




39 


7 


55 


8 




24 


( 


40 


8 


56 


9 




25 


) 


41 


9 


57 


10 




26 


* 


42 




58 


11 




27 


+ 


43 


t 


59 


12 


BW 


28 


, 


44 


<C 


60 


^^^^^1 13 


@ 
^^1 


29 
30 
31 


1 


45 
46 
47 




61 


■ SWITCH TO HH 

■ LOWER CASE MLM 


62 


15 


63 
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PRINTS 


CHRS 


@ 


64 


A 


65 


B 


66 


C 


67 


D 


68 


E 


69 


F 


70 



PRINTS 


CHRS 


PRINTS CHRS 


PRINTS 


CHRS 


U 


85 


'^ 


106 


^ 


127 


V 


86 


J 


107 




128 


w 


87 


1 


108 




129 


X 


88 


l\ 


109 




130 


Y 


89 


/ 


110 




131 


z 


90 


n 


111 




132 


t 


91 


n 


112 


f1 


133 


6^ 


92 


• 


113 


13 


134 


] 


93 




114 


f5 


135 


t 


94 


¥ 


115 


f7 


136 


^ 


95 


1 


111 


f2 


137 


H 


96 


1 

ri 


117 


f4 


138 


♦ 


97 


^ ■ 


118 


f6 


139 




98 


o ■ 


119 


f8 


140 




99 

100 
101 


1 ^ 


120 
21 
22 




'l41 




1 SWITCH TO 
1 UPPER HASF 


|l42 






143 




102 




23 


IJW^ 


144 




103 


iS ^ 


24 


ffi^ 


145 




104 


rn 1 


25 




146 


^ 


105 


TT 1 


26 


iffn 


147 



146 



PRINTS CHRS 


PRINTS CHRS 


PRINTS CHRS 


PRINTS CHRS 


M '^^ 


BQ 1 


59 


1 170 


1 


181 


149 


^g- 


160 


-! 171 


1 


182 


150 


E ■ 


161 


^ 172 


l~ 


183 


151 


M - 


162 


L 173 


P 


184 


152 


ii 

1 


163 


^ 174 


u 


185 


153 


1 - 

! 


164 


^ 175 


J 


186 


154 


1 


165 


p 176 


LlJ 


187 


155 


m 


166 


J- 177 


n 


188 


BS3 156 




167 


rr ''^ 


J 


189 


M 157 


b 


168 


179 


1 


190 


D3 158 


r\ 


169 


ru 180 


5 


191 
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APPE^DIX K: 

DERIVING MATHEMATICAL FUNCTIONS 

Functions that are not intrinsic to VIC BASIC may be calculated as follows: 



FUNCTION 


VIC BASIC EQUIVALENT 


SECANT 


SEC(X) = 1/C0S(X} 


COSECANT 


CSC(X) = 1/SIN{X} 


COTANGENT 


COT(X) = in-AN(X) 


INVERSE SINE 


ARCSIN(X) = ATN(X/SQR(- X-X + 1)) 


INVERSE COSINE 


ARCCOS(X)= -ATN(X/SQR 




(-X'X + 1))+ ni2 


INVERSE SECANT 


ARCSEC(X) = ATN(X/SQR(X'X- 1}) 


INVERSE COSECANT 


ARCCSqX) = ATN(X/SQR(X 'X - 1)) 




+ (SGN(X)-1)* KI2 


INVERSE COTANGENT 


ARCOT(X) = ATN(X) + 7CI2 


HYPERBOLIC SINE 


SIN H (X) = {EXP(X) - EXP( - X))/2 


HYPERBOLIC COSINE 


COSH(X) = (EXP(X) + EXP( - X))I2 


HYPERBOLIC TANGENT 


TANH{X) = -EXP(-X)/{EXP{x)+EXP 




(-X)r2+1 


HYPERBOLIC SECANT 


SECH(X) = 2/(EXP(X) + EXP( - X)) 


HYPERBOLIC COSECANT 


CSCH(X) = 2/{EXP(X) - EXP( - X)) 


HYPERBOLIC COTANGENT 


COTH(X) = EXP(- X)/(EXP(X) 




-EXP[-X)}'2+1 


INVERSE HYPERBOLIC SINE 


ARCSINHfX) = LOG(X + SQR(X-X + 1» 


INVERSE HYPERBOLIC COSINE 


ARCCOSH(X) = LOG{X + SQR{X*X - 1}) 


INVERSE HYPERBOLIC TANGENT 


ARCTANH(X) = L0G((1 +X)/(1 -X))/2 


INVERSE HYPERBOLIC SECANT 


ARCSECH{X) = LOG({SQR 




(-X-X+1}+1);X) 


INVERSE HYPERBOLIC COSECANT 


ARCCSCH(X) = LOG((SGN(X)*SQR 




(X*X + 1)/x) 


INVERSE HYPERBOLIC COTANGENT 


ARCCOTH(X) = LOG{(X + 1)/(X - 1))^2 



( 
( 
c 
( 
( 
c 

c 

c 

( 

c 

( 

c 

c 

c 

c 

c 

c 

c 

( 

c 

c 



( 
( 
c 
c 
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APPENDIX L: 

PINOUTS FOR INPUT/OUTPUT DEVICES 

Here is a picture of the I/O ports on \he VIC: 



K — m 



^^\ 

i;-^- 



J 




1) Game I/O 4) Serial I/O (disk) 

2) Memory Expansion 5) Cassette 

3) Audio and Video 6) User Port (modem) 



1)GAMEi/0 



I J J 4 

o o o o o 



o o o o 

ti V H 5 




prN# 


TYPE 


NOTE 


1 


JOY0 




2 


JOY1 




3 


J0Y2 




4 


J0Y3 




5 


POTY 




6 


LIGHT PEN 




7 


+ 5V 


MAX. 100mA 


8 


GND 




9 


POTX 
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2) MEMORY EXPANSION 



12 3 4 5 6 7 8 9 10 1112 13 14 15 16 17 1819 20 2122 



ABCDEFHJ KLMNPRSTUVWXYZ 



PIN# 


TYPE 


1 


GND 


2 


CDji 


3 


GDI 


4 


CD2 


5 


CD3 


6 


CD4 


7 


CDS 


8 


CD6 


9 


CD7 


1(j 


BLK1 


11 


BLK2 



PtN# 


TYPE 


A 


GND 


B 


GA0 


C 


CA1 


D 


CA2 


E 


GA3 


F 


CA4 


H 


CAS 


J 


CA6 


K 


CA7 


L 


CAB 


M 


CA9 



PIN# 


TYPE 


12 




BLK3 


13 


BLK5 


14 


RAMI 


15 


RAM2 


16 


RAM3 


17 


VRW 


18 


CR/W 


19 


IRQ 


20 


NC 


21 


+ 5V 


22 


GND 



P1N# 


TYPE 


N 


CA10 


P 


CA11 


R 


CA12 


S 


CA13 


T 


f/02 


U 


\m 


V 


S(?2 


w 


NMl 


X 


RESET 


Y 


NC 


z 


GND 



( 
( 
( 
( 
( 
( 
( 
c 
c 
c 
c 
c 
c 
c 
c 
c 
c 
c 
( 
c 
c 
c 
c 
c 

c 
c 
c 
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3) AUDIO/VIDEO 




PIN# 


TYPE 


NOTE 


1 


+ 5V REG 


lUmA MAX 


2 


GND 




3 


AUDIO 




4 


VIDEO LOW 




5 


VIDEO HIGH 





4) SERIAL I/O 




PIN # 


TYPE 


1 
2 

3 
4 
5 
6 


SERIAL SRQ IN 

GND 

SERIAL ATN IN /OUT 

SERIAL CLK IN/OUT 

SERIAL DATA IN /OUT 

RESET 



5) CASSETTE 

12 3 4 5 6 



A B C D E F 



PIN # 


TYPE 


A-1 


GND 


B-2 


+ 5V 


C-3 


CASSETTE MOTOR 


D-4 


CASSETTE READ 


E-5 


CASSETTE WRITE 


F^ 


CASSETTE SWITCH 
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6) USER I/O 



1 2 3 



5 6 7 8 9 10 11 12 



ABCDEFHJKLMN 



PIN# 


TYPE 


NOTE 


PIN# 


TYPE 


NOTE 


1 


GND 




A 


GND 




2 


+ 5V 


lOfflmA MAX. 


B 


CB1 




3 


RESET 




C 


PB9 




4 


JOYffl 




D 


PB1 




5 


J0Y1 




E 


PB2 




6 


J0Y2 




F 


PB3 




7 


LIGHT PEN 




H 


PB4 




8 


CASSETTE SWITCH 




J 


PBS 




9 


SERIAL ATN IN 




K 


PB6 




n 


+ 9V 


IfldmA MAX. 


L 


PB7 




11 


GNO 




M 


CB2 




12 


GND 




N 


GND 





( 
( 
c 
c 
c 
c 
c 
c 
c 
c 
c 

( 

c 
c 

( 
c 
( 
c 
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APPENDIX N: ERROR MESSAGES 

This appendix contains a complete list of the error messages 
generated by the VIC, with a description of the causes. 

BAD DATA.. .String data was received from an open file, but the pro- 
gram was expecting numeric data. 

BAD SUBSCRIPT.. .The program was trying to reference an element of 
an array whose number is outside of the range specified in the DIM 
statement. 

CAN'T CONTINUE.. .The CONT command will not work, either 
because the program was never RUN, there has been an error, or a 
line has been edited. 

DEVICE NOT PRESENT... The required I/O device was not available for 
an OPEN, CLOSE, CMD, PRINTS, INPUTS, or GET#. 

DIVISION BY ZERO... Division by zero is a mathematical oddity and 
not allowed. 

EXTRA IGNORED.. .Too many items of data were typed in response to 
an INPUT statement. Only the first few items were accepted. 

FILE NOT FOUND. ..If you were looking for a file on tape, and END- 
OF-TAPE marker was found. If you were looking on disk, no file with 
that name exists. 

FILE NOT OPEN. ..The file specified in a CLOSE, CMD, PRINTS, IN- 
PUTS, or GETS, must first be OPENed. 

FILE OPEN.. .An attempt was made to open a file using the number of 
an already open file. 

FORMULA TOO COMPLEX. ..The string expression being evaluated 
should be split into at least two parts for the system to work with. 

ILLEGAL DIRECT. ..The INPUT statement can only be used within a 
program, and not in direct mode. 

ILLEGAL QUANTITY.. .A number used as the argument of a function 
or statement Is out of the allowable range. 

LOAD.. .There is a problem with the program on tape. 

NEXT WITHOUT FOR.. .This is caused by either incorrectly nesting 
loops or having a variable name in a NEXT statement that doesn't cor- 
respond with one in a FOR statement. 

NOT INPUT FILE.. .An attempt was made to INPUT or GET data from a 
file which was specified to be for output only. 
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NOT OUTPUT FILE. ..An attempt was made to PRINT data to a file 
which was specified as input only. 

OUT OF DATA... A READ statement was executed but tliere is no data 
left unREAD in a DATA statement. 

OUT OF MEMORY... There is no more RAM available for program or 
variables, Ttiis may also occur when too many FOR loops have been 
nested, or when there are too many GOSUBs in effect. 

OVERFLOW... The result of a computation Is larger than the largest 
number allowed, which is 1.70141884E + 38. 

REDIM'D ARRAY.. .An array may only be DIMensioned once. If an ar- 
ray variable is used before that array is DIM'd, an automatic DtM 
operation is performed on that array setting the number of elements 
to ten, and any subsequent DIMs will cause this error. 

REDO FROM START.. .Character data was typed in during an INPUT 
statement when numeric data was expected. Just re-type the entry so 
that it is correct, and the program will continue by itself. 

RETURN WITHOUT GOSUB...A RETURN statement was encountered, 
and noGOSUB command has been issued. 

STRING TOO LONG...A string can contain up to 255 characters. 

SYNTAX... A statement is unrecognizable by the VIC. A missing or ex- 
tra parenthesis, misspelled keywords, etc. 

TYPE MISMATCH. ..This error occurs when a number is used in place 
of a string, or vice-versa. 

UNDEF'D FUNCTION... A user defined function was referenced, but it 
has never been defined using the DEF FN statement. 

UNDEF'D STATEMENT... An attempt was made to GOTO or GOSUB or 
RUN a line number that doesn't exist. 

VERIFY,,, The program on tape or disl< does not match the program 
currently in memory. 
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Abbreviations, BASIC commands 133 

Accessories 106, 109 

Addition 24, 115 

AND operator 115 

Animation 50, 51-66, 99, 139, 143 

Arithmetic Operators 24, 1 16 

Arithmetic Formulas 24, 115, 123, 148 

Arrays 114-120 

ASCfuntion 131, 145 

ASCII ctiaracter codes 145 

ATN function 129 
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BASIC 

abbreviations 133 

commands 115 

operators 115 

statements 119 

variables 86. 113 
Buffer 110 



Calculations 24 

Cassette tape recorder 107, 109 

Cassette port 106 

CHR$ function 102, 131, 145 

CLR statement 119 

CLR/ HOME key 6. 18 

CIocl<114 

CLOSE statement 110, 119 

Color 

Keys 19, 32 

t^emory map 63. 143-144 

Screen and Border 33, 36, 38, 39, 134 
Commands, BASIC 115 
Commodore key (see grapfiics key) 
Connecting tfie VIC to TV / monitor V 
CONT command 115 
CTRL key 18 
CRSR keys 18, 60 
Correcting errors 8, 50 
Cursors, 18, 60 
COSine function 129 



DATA statement 79, 119 

Data, saving & retrieving from tape 109 

DEFine statement 120 

Delay Loop 55, 78, 96 

DELete key 3, 8. 19 

DIMension statement 120 

Division 115, 160 

Duration (see FOR....NEXT) 



Editing programs 8, 50 
END statement 121 
Equal, not-equal-to sign 115 
Equations 115 
Error Messages 6, 160 
Expansion port 106, 149 
Exponent function 129 
Exponentiation 115 



Files, cassette tape 109 
FOR statement 121 
FOB.„.NEXT loop 121 
FRE function 132 
Functions 129 



Games to try 153 

Game controls 108 

Game port 108, 149 

GET statement 89, 122 

GETS statement 123, 111 

Getting started V, 3 

GOSUB statement 123 

GOTO statement 123 

Qraptiic keys 14. 19 

Graptiic symbols 14, 142, 146-147 

Greater than 115 
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Hyperbolic functions 148 
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IEEE-488 Interface 107 
IF...THEN statement 123 
INPUT statement 84, 124 
INPUT# statement 111 
INSert key 3, 8, 19 
INTeger (unction 129 
Integer variables 113 
I lO pinouts 149 
I/O ports 106, 149 
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LEFTS function 131 

LENgth function 131 

Less than 115 

LET statement 124 

Line numbers 78 

LIST command 8. 9. 50. 1 16 

LOAD command 109, 116 

Loading programs on tape 109 

LOGarlthm function 130 

Loops, time delay 55, 78. 96 

Lower case ctiaracters 20 
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Mailing label program 92 
Mathematics 

formulas 24, 115, 123, 148. 160 

function table 148 

symbols 115 
Memory 36. 80. 125, 126, 130 
Memory expansion 107 
MID$ function 43, 131 
Modulator, RF VI 
Multiplication 115 
Music 

pitch 68 

sound effects 135 

table of notes 73 

VIC piano 75 

writing songs 77 
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Names 

program 109 

variable 86 
Nested Loops 122 
NEW command 7 
NEXT statement 125 
Noise 71, 74 
NOT operator 115 
Numbers 23, 24, 115, 123 
Numeric variables 86, 1 1 3 



ON statement 125 
OPEN statement 126 
Operators 
Arithmetic 24. 114 
Logical 115 
Relational 115 



Parenttieses 115 

PEEK function 130 

Peripherals 106 

Pi 20 

POKE statement 36, 80, 125 

Ports. I /O 149 

POS function 132 

PRINTstatement 5, 21, 127 

PRINT# 727 

Programs 

editing 8, 50 

line numbering 73 

loading / saving on tape 109 
Prompt 84 



Quotation marlts 96 



Random numbers 40, 43, 103 
READ statement 79, 128 
RE(v1art< statement 128 
Reserved Words 86 
Reset (see Restore Key) 
Restore key 17, 26 
RESTORE statement 128 
Return ttey 18 
RETURN statement 128 
RIGHTS function 132 
RND function 40,43, 130 
ROCKET COMMAND program 153 
RUN command 117 
RUN / STOP key 19 



SAVE command 109, 117 

Saving programs on tape 109 

Screen memory maps 63, 143-144 

Serial bus 107 

SON function 130 

Shift key 18 

SINe function 131 

Sound effects 135 

SPC function 132 

SQR function 131 

ST system variable 86 

Stop key 19 

STOP command 128 

String variables 42. 86, 113 

STRS function 132 

Subscripted Variables 114 

Subtraction 115 

SYS statement 128 

Syntax Error 6 
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TAB function 132 

TAN function 131 

Tape Cassette operation 109 

Tl variable 114 

TIS variable 114 

Time, setting VIC clock 114 r 

TO in BASIC statements 121 ^ 



Tones 70 

TV, connecting the VIC V 
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Your Name in Ligtits (program) 95 
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Upper / lower case motJe 20 

USR function 131 ( 

User-defined function (DEF) 120 
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V • 

VALue function 132 , 

Variables ^ 

Array 114 >- 

Floating point 113 *- 

Integer 113 ^ 

Numeric 86, 113 • 

String 42, 86, 113 jm 

VERIFY command 109, 118 • 

VICTIPS 3. 8, 16, 39, 40, 47, 50, 78, 96 

VIC person {see animation) 

Video port / connections V, 150 

Volume 69, 71,72 
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ABUSER FRIENDLY" COMPUTER 

The new VIC computer is designed to be the most 
user friendly computer on the market. ..friendly in 
price, friendly in size, friendly to use and expand. 

With the VIC, Commodore is providing a computer 
system which helps almost anyone get involved in 
computing quickly and easily. ..with enough built-in 
expansion features to let the system "grow" with the 
user as his knowledge and requirements become 
more sophisticated. 

VIC owners who wish to learn more about computing 
should ask their Commodore dealer about these 
other self-teaching and reference materials: 

• VIC LEARNING SERIES... a library of self-teaching 
books and tapes/cartridges which help you learn 
about computing and other subjects. Volume I in the 
VIC Learning Series is called "Introduction to 
Computing. ..On the VIC". Volume II is called 
"Introduction to BASIC Programming". Subsequent 
titles will include Animation, Sound and Music, and 
more. 

. VIC PROGRAMMER'S REFERENCE GUIDE...a 
comprehensive guide to the VIC20 Personal 
Computer, including important information for new 
and experienced programmers alike. 

. VIC-PROGRAM TAPES, CARTRIDGES AND 
DISKS. ..a growing library of recreational, 
educational and home utility programs which let you 
use the VIC to solve problems, develop learning 
skills, and play exciting television games. These 
easy-to-use programs require no previous computer 
. experience. 
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